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Abstract 


Networking Services/2 allows any workstation running OS/2 EE to participate in 
an APPN network. 


This document provides information on how to install, customize and operate 
Networking Services/2 in various APPN topologies. 


The intended audience includes those planning to install Networking Services/2 
and engineers specializing in OS/2 or networks. 


Information about the APPC enhancements included in Networking Services/2 is 
not the focus of this book. 


A knowledge of the APPN architecture and OS/2 Communications Manager is 
assumed. 
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Special Notices 


This publication is intended to help the customer install, customize and operate 
Networking Services/2 in an APPN environment. The information in this publica- 
tion is not intended as the specification of the programming interfaces that are 
provided by Networking Services/2 for use by customers in writing programs to 
request or receive its services. See the PUBLICATIONS SECTION of the IBM 
Programming Announcement for more information about what publications are 
considered to be product documentation. 


References in this publication to IBM products, programs or services do not 
imply that IBM intends to make these available in all countries in which IBM 
operates. Any reference to an IBM product, program, or service is not intended 
to state or imply that only IBM’s product, program, or service may be used. Any 
functionally equivalent program that does not infringe any of IBM’s intellectual 
property rights may be used instead of the IBM product, program or service. 


Information in this book was developed in conjunction with use of the equipment 
specified, and is limited in application to those specific hardware and software 
products and levels. 


IBM may have patents or pending patent applications covering subject matter in 
this document. The furnishing of this document does not give you any license to 
these patents. You can send license inquiries, in writing, to the IBM Director of 
Commercial Relations, IBM Corporation, Purchase, NY 10577. 


The information contained in this document has not been submitted to any 
formal IBM test and is distributed AS IS. The use of this information or the 
implementation of any of these techniques is a customer responsibility and 
depends on the customer’s ability to evaluate and integrate them into the cus- 
tomer’s operational environment. While each item may have been reviewed by 
IBM for accuracy in a specific situation, there is no guarantee that the same or 
similar results will be obtained elsewhere. Customers attempting to adapt these 
techniques to their own environments do so at their own risk. 


Any performance data contained in this document was determined in a con- 
trolled environment, and therefore, the results that may be obtained in other 
operating environments may vary significantly. Users of this document should 
verify the applicable data for their specific environment. 


The following document contains examples of data and reports used in daily 
business operations. To illustrate them as completely as possible, the examples 
contain the names of individuals, companies, brands, and products. All of these 
names are fictitious and any similarity to the names and addresses used by an 
actual business enterprise is entirely coincidental. 


Reference to PTF numbers that have not been released through the normal dis- 
tribution process does not imply general availability. The purpose of including 
these reference numbers is to alert IBM customers to specific information rela- 
tive to the implementation of the PTF when it becomes available to each cus- 
tomer according to the normal IBM PTF distribution process. 


© Copyright |BM Corp. 1991 XV 


The following terms, which are denoted by an asterisk (*) in this publication, are 
trademarks of the International Business Machines Corporation in the United 
States and/or other countries: 


ACF/VTAM 

AS/400 

ES/9000 

IBM 

MVS/ESA 

MVS/XA 

NetView 

Operating System/2 
OS/2 

OS/400 

Presentation Manager 
PS/2 

SAA 

systems Application Architecture 
VTAM 


xvi Networking Services/2 


Preface 


This document is intended as a help in installing, customizing and operating Net- 
working Services/2 in an APPN environment. 


The focus of this publication is on the APPN functions implemented by Net- 
working Services/2 While some information about APPC enhancements is pro- 
vided, this publication is not focusing on them. Also, this publication is not 
intended to be a tutorial on the APPN architecture. Other publications provide 
tutorial information. 


A knowledge of the APPN architecture, the OS/2 EE Communications Manager 
and the OS/2 environment is assumed. 


Purpose 


The introduction of Advanced Peer-to-Peer Networking (APPN) into the personal 
system environment will greatly ease the system definition burden in this envi- 
ronment as well as greatly increase networking flexibility. 


With Networking Services/2, a workstation using the OS/2 EE operating system 
and Communications Manager may participate in an APPN network as a LEN 
node, end node or network node. 


This publication is intended to assist APPN experts, OS/2 Communications 
Manager experts and beginners with the OS/2 EE operating system in quickly 
installing Networking Services/2 and customizing it for their needs. 


Furthermore, the reader will gain an understanding of the function provided by 
Networking Services/2 and how to establish new networks as well as how to 
incorporate it into existing networks. 


Audience 


This publication is intended for any person who will need to install, customize 
and operate Networking Services/2: 


e Customers: 
— Network designers 
— Network installation staff 
— Network operations 
— PS/2 users 
e IBM employees: 
— Network or OS/2 system engineers 


— Sales representatives 
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Organization 


The first chapter provides information on the intended technical scope of this 
publication as well as where to go for additional information. 


Chapters 2 through 8 describe how to implement Networking Services/2 in a 
workstation. They explains the customization of the workstation for various 
types of connections that may be used and give examples of building an 
APPN network. | | 


Chapters 9 through 13 contain miscellaneous OS/2 APPN networking consid- 
erations (OS/2 network evolution, network management, performance consid- 
eration and debugging). 


The appendixes contain reference files needed to use Networking Services/2. 
Having these files as well as the definition files from Chapter 7, “Sample 
Configurations” in only one book will save a lot of time while building a con- 
figuration, operating the product or debugging a communications problem. 


Chapters 


The contents of the chapters are as follows: 
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Chapter 1, “Introduction” on page 1 shows the different APPN network 
topologies used throughout the book. It details the different types of nodes 
documented in the book. Sections 1.1, “APPC Concepts Overview” on > 
page 1, and 1.2, “APPN Concepts Overview” on page 4, give definitions of 
terms used in Networking Services/2. For more information refer to the 
“Related Publications” on page xxi. 


Chapter 2, “Overview of Networking Services/2” on page 13 explains the 
enhancements brought by Neiworking Services/2 to the Communications 
Manager. 


Chapter 3, “Planning Considerations” on page 17 assists in the planning of 
an APPN network and the preparation for installing Networking Services/2. 


Chapter 4, “Installation Procedures” on page 23 describes the installation 
and deinstallation of Networking Services/2. 


Chapter 5, “Configuration Procedure” on page 29 explains the relationships 
between the files used by Networking Services/2 and how to build them. - 


Chapter 6, “Using the Presentation Manager Interface” on page 33 shows 
how to use the Presentation Manager screens of Networking Services/2. 
Although these screens allow you to define your workstation as a node, this 
is not discussed here in detail but in the following chapter. 


Chapter 7, “Sample Configurations” on page 57 describes step by step how 
to define any type of node with any type of connection with the Presentation 
Manager panels. Furthermore, you will find useful information about each 
type of configuration. If you don’t know how to customize your node or if you 
are not sure of what you get with a selection proposed in a panel, this 
chapter will give you the answer. Use this chapter as a reference. 


Chapter 8, “Defaults Supplied by Networking Services/2” on page 111 lists 
the defaults for Networking Services/2. 


Chapter 9, “Network Design Evolution” on page 117 describes how to make 
your current network take the maximum advantages of Networking 
Services/2. 


e Chapter 10, “Management Services” on page 123 discusses management 
considerations in the Networking Services/2 environment. 


e Chapter 11, “AS/400 Considerations” on page 131 provides information that 
is useful to those who are connecting Networking Services/2 with AS/400 
systems. 


e Chapter 12, “Performance Study” on page 161 provides some benchmark 
comparisons between Networking Services/2 and the Communications Man- 
agers APPC. 


e Chapter 13, “Debugging” on page 177 lists basic checks to do when you get 
in trouble. Then it explains how to use the tracing facilities. 


Audience 
The chapters that will be of the most interest to the following groups of people 
are: 


e Everyone should read: 


Chapter 3, “Planning Considerations” on page 17, 
Chapter 4, “Installation Procedures” on page 23, and 
Chapter 5, “Configuration Procedure” on page 29. 


e Newcomers to APPN and APPC should read: 
Chapter 1, “Introduction” on page 1. 
e PS/2 users should read: 
Chapter 6, “Using the Presentation Manager Interface” on page 33. 
* Communications Manager specialists shou!d read: 
Chapter 2, “Overview of Networking Services/2” on page 13. 
e People connecting to AS/400s should read: 
Chapter 11, “AS/400 Considerations” on page 131. 


e Support personal (designers, planners, installation staff, operations) should 
read: 


Chapter 9, “Network Design Evolution” on page 117, 
Chapter 10, “Management Services” on page 123, 
Chapter 11, “AS/400 Considerations” on page 131, 
Chapter 12, “Performance Study” on page 161, and 
Chapter 13, “Debugging” on page 177. 


e Useful reference chapters include: 


Chapter 7, “Sample Configurations” on page 5/7, and 
Chapter 8, “Defaults Supplied by Networking Services/2” on page 111. 
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Related Publications 


The following publications are considered particularly suitable for a more 
detailed discussion of the topics covered in this document. 


Prerequisite Publications 
e IBM Operating System/2* Extended Edition Version 1.2 End User Publications, 


(S01F-0285-00) or /BM Operating System/2 Extended Edition Version 1.3 End 
User Publications, (S01F-0289-00) contains the publication set provided with 
the OS/2 program package. In this set you may find useful: 


— IBM Operating System/2 Getting Started 


— IBM Operating System/2 Extended Edition Version 1.x User’s Guide, 
Volume 2: Communications Manager 


e APPN Architecture and Product Implementation, GG24-3669 


Additional Publications 


Networking Services/2 Publications 


OS/2 Publications 


Networking Services/2 Installation and Network Administrator’s Guide, 
$C52-1110 


Networking Services/2 System Management Programming Reference, 
SC52-1111 


Networking Services/2 APPC Programming Reference, SC52-1112 
Networking Services/2 Problem Determination Guide, $C52-1113 


Networking Services/2 License Information, SC52-1114 


OS/2 Extended Edition Version 1.2 System Administrator's Guide for Commu- 
nications, SO1F-0261 (can no longer be ordered) 


OS/2 Extended Edition Version 1.3 System Administrator's Guide, GO1F-0302 
OS/2 Extended Edition Version 1.2 APPC Programming Reference, SO1F-0263 
OS/2 Extended Edition Version 1.3 APPC Programming Reference, SO1F-0295 


SNA Architecture Publications 
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IBM SNA Technical Overview, GC30-3073 


SNA Format and Protocol Reference Manual: Architecture Logic for LU Type 
6.2, SC30-3269 


SNA Format and Protocol Reference Manual: Architecture Logic for Type 2.1 
Nodes, $C30-3422 | 


SAA Common Programming Interface Communications Reference, 
$C26-4399-03 


Xxi 


e IBM Systems Network Architecture Management Services Reference, | 
SC30-3346-03 7 | 


AS/400 Publications a 
e AS/400 PC Support: Technical Reference, $C21-8091 


e AS/400 PC Support: Messages and Problem Analysis Guide, SC21-8093 
© AS/400 PC Support: DOS Pianning and Installation Guide, $C21-8195 
e AS/400 PC Support: OS/2 Planning and Installation Guide, $C21-8196 
e AS/400 PC Support: DOS Operations Reference, $C21-8197 
e AS/400 PC Support: OS/2 Operations Reference, SC21-8198 
-@ AS/400 PC Support: DOS User’s Guide, $C21-8199 
e AS/400 PC Support: OS/2 User’s Guide, $C21-8200 
e AS/400 Communications: User’s Guide, SC21-9601 


¢ AS/400 Communications: Advanced Peer-to-Peer Networking User’s Guide, 
SC21-8188 


e AS/400 Communications: Communications and Systems Management User’s 
Guide, SC21-9661 


Other ITSC Publications 
e AS/400 PC Support, GG24-3255 


e AS/400 PC Support under OS/2 Extended Edition Version 1.2, GG24-3446 
e AS/400 Network Management in a Peer Environment, GG24-3284 


e Management of AS/400 in Subarea Network using NetView Products, 
GG24-3289 


e AS/400 Advanced Peer-to-Peer Networking (APPN), GG24-3287 
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Chapter 1. 


introduction 


Networking Services/2 greatly enhances the networking capabilities of personal 
workstations by providing Advanced Peer-to-Peer Networking (APPN) capability 
for systems running the OS/2* EE operating system. APPN provides a flexible 
routing scheme that improves network availability, determines the “best” route 
for exchanging data within a network and reduces the amount of configuration 
information the customer needs to define. In APPN all computers are treated as 
peers in a network, enabling customers to access data located anywhere in a 
network. Networking Services/2 also improves the performance of Advanced 
Program-to-Program Communications (APPC) and provides the Systems Applica- 
tion Architecture* (SAA*) Common Programming Interface for Communications 
(CPI-C) as well as an enhanced version of the APPC API available in Communi- 
cations Manager. Networking Services/2 also significantly increases the 
ease-of-use of APPC in the OS/2 environment. 


This document focuses on information about the APPN functions provided by 
Networking Services/2 in the OS/2 implementation. It is intended to assist cus- 
tomers in installing, customizing and operating Networking Services/2 through its 
Presentation Manager” interface. 


This document does not focus on the APPC improvements or the programming 
interfaces for APPC. Information about the APPC programming interface can be 
found in the /BM SAA Networking Services/2 APPC Programming Reference. 
Information about the CPI-C programming interface can be found in Version 3 or 
later of the SAA Common Programming Interface Communications Reference. 
The appendix for Networking Services/2 will not be in a version earlier than 
Version 3. 


This document also does not provide a tutorial on the Advanced Peer-to-Peer 
Networking architecture. An excellent tutorial on APPN can be found in the 
APPN Architecture and Product Implementation publication as well as an over- 
view of the various product implementations of APPN. 


1.1 APPC Concepts Overview 


While a tutorial on APPC and APPN will not be presented, understanding of 
some basic terms and concepts will assist the APPC and APPN novice in under- 
standing the functions provided by Networking Services/2. 


The following are some APPC concepts that are used in NS/2. 


Adapter 
Physical communication device that is installed in the workstation. It may have 
a number if there are many of the same type. 


Alias 
Designates a resource instead of its real name. 
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Attach Manager | 

Part of the subsystem that starts a local remotely startable transaction program. 
When its status is “active” then a local transaction program may be started by a 
remote transaction program. 


Class of Service 
Set of information that is used to select the route that is acceptable for a session 
request and find the best available path. 


Conversation 
Communications session between two transaction programs. A session may 
only support one conversation at a time. 


conversation 


Dependent LU 
An LU that depends on a host to be activated. 


| bind : 
SSCP DLU 


Independent LU 


An LU that performs communications that do not require a host to send the bind. 


bind 


Link 


A logical link between two nodes. 


Link Station | 
A control block (piece of storage) on the adapter. One link station is needed for 
one conversation or for one session. 


LU Type 6.2 
This is the only type of LU that can be “independent.” When it is independent it 
supports multiple and parallel sessions. 


parallel sessions EUR PS 


LU 
6.2 


LUA 
LU 
6.2 
multiple sessions 
LU 
6.2 


LUA has multiple sessions (three sessions). The sessions with LUB are parallel 
sessions. 


Mode 
Defines session characteristics such as the size of the smallest message to be 
exchanged on a session. The mode also implies a “class of service.” 


Partner LU 
An LU that the local LU wants to communicate with. 


Session 
A session is a path between two LUs that carries data. A session may only 
support one conversation at a time. 


session 


Transaction Program | 
Program that uses APPC to exchange information with another program. 


conversation 
TP ++ TP 


Relationship between TPs and LUs 

A TP will communicate with another TP by issuing verbs to its LU. That LU will 

communicate with the partner LU and will pass the information being communi- 
cated to the partner TP when the partner TP issues the appropriate verbs. The 

TPs will have a conversation by means of a series of such verbs being issued to 
the LUs. 
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conversation 


ee ee ee ee ee eee ee 


APPC verbs return codes return codes 


session 


1.2 APPN Concepts Overview 


The following are some APPN concepts that are used in Networking Services/2: 


APPN 
Advanced peer-to-peer networking nodes provide a set of functions and proto- 
cols for participation in a peer-to-peer decentralized network. 


A node in which APPN is fully implemented may only contain the definitions of 
its own resources (LUs, links to its neignbors) and will dynamically learn about 
the location and resources of the other nodes in the network. 


T2.1 Node 
Allows direct communication between two similar nodes without needing assist- 
ance from an SSCP in establishing the connection. 


Control Point 

Is responsible for managing the node and its resources and, in an APPN end 
node, for communicating with an adjacent network node server’s control point to 
obtain APPN network services. 


A control point is an LU and it may be the only LU of the node. Whenever it is 
possible the CP should be the only LU of the node. This saves resources in the 
node and the CP-LU name is more widely known. The CP-LU name for network 
nodes is in the topology database kept in every node and the CP-LU for an end 
node is known by the network node server. 


CP-CP Sessions 

To perform directory services and topology and route selection services, adja- 
cent APPN network nodes throughout the APPN network use a pair of parallel 
CP-CP sessions to exchange network information and APPN end nodes get 
access to these services via a pair of CP-CP sessions with there network node 
server. Here are the two possible kinds of CP-CP sessions: 


CP-CP session 
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Network Node 
A node capable of providing full APPN function can: 


Participate in network-wide distributed directory searches for LUs, 
caching search results, and directed verification of continued LU avail- 
ability to the network. The APPN architecture allows these searches to 
be extended in the future to include a wide range of resource types, such 
as transaction programs and user IDs. 


Broadcast a network topology database update to other APPN network 
nodes whenever its own load level or the state of one of its local links 
changes significantly. In this way, every APPN network node has a copy 
of the network topology database (with information on network nodes 
and links between them). 


Dynamically compute session routes through an APPN network, based 
on the current topology information, the locations of the session partners, 
and the requested classes of service. 


Provide necessary DLC signaling information to APPN end nodes con- 
nected to a shared-access transmission facility, such as a token-ring 
LAN. 


Support intermediate session routing. This includes the 
activation/deactivation of session routes through an APPN network, as 
well as the hop-by-hop pacing and segmenting of session traffic. 


Provide management services support. This includes the ability to be 
defined as a management services entry point or focal point for network 
problem management. 


As the following diagram illustrates, a network node can be both the end point of 
sessions as well as provide the intermediate session routing. 


sessions 


Network Node Server 

A network node whose role is to provide network services (directory services, 
route selection services, etc.) for specific end nodes attached to it. These end 
nodes are defined as being in its domain. 


It receives resource registration messages from the APPN end nodes in its 
domain. 
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In this example an LU of the APPN network can locate EN3 and its LUs only 
through EN3’s server NNB. ENS can search for another LU only through its 
server NNB. Once the partner LU is located, the calculated route for the session 
may use the link from EN3 to NNA or the link form EN3 to NNB depending on 
which was considered to be preferred at that time for the class of service being 
used. 


End Node 
Operates in a peer environment for LU-LU sessions while providing additional 


APPN functions: 
— Selecting an APPN network node to be its network node server. 
— Dynamically registering its LUs with its network node server. 


— Allowing itself to be searched for LUs that it chooses not to register with 
the network. Generic or wild-card entries can also represent the end 
node’s resources at the server to reduce the directory load. 


— Submitting distributed directory search requests to its network node 
server, and obtaining session-route calculations from its server when ini- 
tiating LU-LU sessions. 


— Supporting parallel links to other APPN nodes in an APPN network. 
LEN Node 


A low entry node implements the basic T2.1 end node protocols without the 
APPN enhancements obtained through CP-CP sessions. 


A node capable of peer-to-peer communication, but unable to make direct use of 
the APPN functions contained within a network node server. 


Primary Host 
A S/370 or ES/9000*-based host containing a focal point (for example NetView’). 


Sample APPN Network 
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Figure 1. The following is an Example of an APPN Network 


In this sample network there are six active sessions: 
LU1--LUA 
LUA--LUB 
LU2--LUZ 
LUX--LUZ 
LUH--LUG 
LUH--LUG 
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lf APPC application programs were written and placed properly, any node in this 
network could directly communicate with any other. 


1.3 Test Environments Established 


The following test environments were set up to obtain much of the information 
contained in this publication: 


e An NS/2 network node with token-ring LAN-attached NS/2 end nodes: 


Token-Ring LAN 


e An NS/2 network node with two token-ring LAN-attached NS/2 end nodes, 
each on a different token-ring LAN: 


e Two NS/2 network nodes, connected through a subarea network, each with 
token-ring LAN-attached end nodes: 
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Host 


Foxes! Token- 
si" Lm} we | fo i 
LAN LAN 


e An NS/2 network node, with token-ring LAN-attached NS/2 end nodes, 
attached to a subarea network: 


ener 


e An NS/2 network node with a token-ring LAN-attached NS/2 end node, a 
token-ring LAN-attached DOS LEN node and an SDLC-attached AS/400 
network node: 
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e An AS/400 used in an APPN network as an intermediate focal point, with a 


focal point in a host: 


NN AS/400 


Token- Inter- Token- 

Ring mediate Ring 
LAN Focal LAN 

Point 


1.4 Connection Types Documented in this Publication 


This publication describes how to configure many of the different types of con- 
nections that would be needed in building a complex APPN network. For the 
most part, building the complex network consists of knowing how to configure 
each of the separate types of connections. This publication will give examples of 
the following types of node configurations: 
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An NS/2 end node migrated from an existing Communications Manager 
APPC configuration 


A direct peer-to-peer connection to an LU in another adjacent node 
An NS/2 network node providing network node services to end nodes 
. An NS/2 end node in the domain of a network node server 


. An NS/2 end node attached to a network node but not receiving network 
node services from that node 


. A NS/2 network node acting as a server for a LEN node 


. A NS/2 end node served by a network node but without CP-CP session and 
thus seen as a LEN node 


. An NS/2 network node connected to another network node 


. An NS/2 network node connected to another network node through a 
subarea | 


. An NS/2 node connection to a host that contains LU 6.2 LUs 
. An NS/2 node connection to a primary host (host with a focal point). 


. An NS/2 end node connected to an AS/400 network node 


. An NS/2 network node connected to an AS/400 network node via SDLC 


. An NS/2 network node connected to an AS/400 network node through a 
subarea. 
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Chapter 2. Overview of Networking Services/2 


Highlights | 
Networking Services/2 is an implementation of the SNA subsystem compo- 
nents for OS/2 EE Versions 1.2 and 1.3. This includes implementations of 
Advanced Peer-to-Peer Networking (APPN) protocols and Advanced 
Program-to-Program Communications (APPC) protocols. Networking 
services/2 Version 1.0’s implementation of APPC and APPN provides for LU 
6.2 communications that is faster and easier to configure than was previously 
possible with OS/2 EE’s Communications Manager alone. In addition, the 
APPC enhancements and APPN improve the usability of APPC with OS/2. 
Specifically, Networking Services/2 offers: 


¢ APPN end node and network node support | 
¢ SAA Common Programming Interface Communications (CPI-C) 


¢ APPC performance improvements - In the token-ring LAN environment, many 
applications see a 100% or more improvement in the speed of their commu- 
nications over what they experienced with OS/2 EE Versions 1.2 and 1.3 
without NS/2. 


e Easier configuration - end node setup can require as few as two or three 
parameters 


e New configuration process for SNA parameters 3 
— Presentation Manager-based panel input _ 
— Editable ASCII Networking Services/2 node definition files (.NDF) 
— API for dynamic configuration changes while APPC remains active 
¢ Reduced system definition _ | 
— Predefined modes and classes of service 
— Implicit partner LUs (inbound and outbound) 
— Implicit modes (inbound and outbound) 
— Ability to define default LU, mode and TP characteristics 
— Discovery of partner LU locations (via APPN) 
— Discovery of partner LU LAN addresses (via APPN) 
e Local/remote transparency (partner Lu in the same node) 
e APPC improvements | 
— Automatic initialization of session limits (via implicit CNOS) 
— New SEND_CONVERSATION and MC_SEND_CONVERSATION verbs 
— Improved diagnostics for allocation failures with sense data 
e Management Services (MS) enhancements 
— API for user-written MS applications a 
— Multiple Domain Support routing in the APPN network 
— APPN/subarea focal point transparency at MS API 
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— “Pseudo” alert focal point support for served end nodes to subarea focal 
point 


— Held alerts for temporary loss of focal point | 
¢ Sample configuration files. 
e Sample programs: 


— APPCMGMT - Management sample program. Issues verbs such as 
Deactivate Logical Link and Deactivate Session (written in the C lan- 
guage). | 

— APPCTELL - Sends a VIOPopUp message to the specified partner LU 
(written in the C language). 


— CPICOBOL - Samples from the SAA Common Programming Interface 
Communications Reference (written in the COBOL language). 


— CPICFILE - File transfer sample using CPl-Communications (written in the 
C language). 


— CPICREXX - Set and extract CPl-Communications side information from 
REXX. 


— DISPLAY - Requests and formats information using the DISPLAY and 
DISPLAY_APPN verbs. Both command line and PM versions are 
included {written in the C language). 


— FILE - File transfer sample using APPC (written in the C language). 


— FILECFG - Configuration sample program. Issues verbs such as Define 
Local LU and Define TP (written in the C language). 


¢ Tools 
— Simplified tracing via CMTRACE and sample APPNT.CMD 
— Trace formatter via FMTTRACE and sample APPNF.CMD 
— Header include files for APPC verbs (C, COBOL, ASM and Pascal) 
— Header include files for CPl-Communications calls (all SAA 


CPi-Communications languages currently supported by OS/2) 


Existing APPC applications need not be modified to take advantage of Net- 
working Services/2 function. 


Networking Services/2 also provides a migration utility to convert your existing 
Communications Manager configuration files to the new Networking Services/2 
configuration files. 


Performance 
e LU 6.2 performance enhancements are in three main areas: new LAN DLC, a 
new OS/2 Frame Manager, and scrubbing of the internal code. As part of the 
APPN architectural additions, new “adaptive pacing” and “segmenting” help 
provide the maximal throughput among machines with different capacities. 
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Usability 


By taking advantage of APPN dynamics and judiciously applying defaults, 
Networking Services/2 is able to reduce the required user-configured param- 
eters for LU 6.2 from around 50 to only three parameters, for an end node. 
SNA configuration information can be stored in a text file. This allows easy 
migration of configurations and makes it easy to modify a configuration with 
a text editor or through a program written by the user. In addition, most con- 
figuration verbs can be issued from the API, allowing dynamic change of the 
SNA configuration while Networking Services/2 is running. Changes can be 
activated without bringing down Communications Manager, only by speci- 
fying parameters when using the Networking Services/2 utility programs. 


For users who don’t care to deal with the text files, a Presentation Manager- 
based configuration utility guides these users through the essential steps of 
setting up their workstation for Networking Services/2. 


For two transaction programs to talk to one another within one machine, the 
Communications Manager used to need either the LOCALDLC package or 
two adapter cards. With Networking Services/2, transaction programs can 
communicate as easily with local programs as with remote programs. No 
adapter cards are required for “within-machine” communication. 


Networking Services/2 and Communications Manager 

Networking Services/2 is not a replacement for OS/2 EE Communications 
Manager, but rather works with Communications Manager to provide new func- 
tion and improved performance. Some of the SNA components of Communi- 
cations Manager have been replaced by NS/2 while other components are used 
by NS/2. 


NS/2 replaces the LAN DLC component while the remaining Communications 
Manager DLCs will be used (SDLC, Twinaxial, and X.25). All of the DLCs are 
configured using the Communications Manager menus. 


NS/2 provides the support for the SNA gateway as well as the LU types (LUO, 
LU1, LU2, and LU3 and LU 6.2). The SNA gateway support and the LU appli- 
cation (LUA) profiles are still configured using Communications Manager 
menus. 


NS/2 uses the message logs and error logs that are a part of Communi- 
cations Manager. It also uses the trace and dump files of Communications 
Manager. The message and error log files are viewed via the Communi- 
cations Manager menus. The trace and dump facilities can be started using 
the Communications Manager menus or NS/2. 


Subsystem management can use either the Communications Manager 
menus or the NS/2 subsystem management verbs. 


APPC and APPN configuration is accomplished via NS/2. The definitions are 
entered in an ASCII file (NDF). From this ASCII file the NS/2 verification 
program creates a binary file (.CF2) that is used during operation. For more 
information about the configuration files used by Communications Manager 
and NS/2 see section 5.1, “The Configuration Files” on page 29. 
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Chapter 3. Planning Considerations 


This chapter gives an overview of hardware considerations, and software prereq- 
uisites as well as some suggested planning activities before installing Net- 
working Services/2. However, for more detailed information consult the OS/2 
System Administrator’s Guide and the IBM SAA Networking Services/2 Installa- 
tion and Networking Administrator Guide. 


3.1 Hardware Considerations 


The OS/2 workstation on which you plan to install Networking Services/2 should 
meet the basic hardware requirements described in the OS/2 System Administra- 
tor’s Guide. 


Hard Disk Storage 


Networking Services/2 installation requires the following amount of fixed disk 
space: 


1. If you do not install the sample programs and headers, you must have: 
3.4MB free on the target drive. 
e 2.7MB for files to be installed. 
e 7OOKB for temporary installation process overhead. 
2. If you install only the samples and header include files, you must have: 
2.2MB free on the target drive. 
e 2.1MB for files to be installed. 
e 100KB for temporary installation process overhead. 
3. If you install both, you must have: 


2./MB free on the target drive and 2.2MB free on the drive chosen for the 
samples. 


e 2./MB for the base code to be installed. 
e 2.1MB for the samples to be installed. 


e 100KB is for temporary installation process overhead. (The 700KB 
process overhead needed for code installation is taken out of the 
2.1MB for the samples before the samples are installed.) 


Networking Services/2 Memory Suggestions 


There are many different operational factors that can affect your memory 
requirements. These include: 


e Number of concurrent user sessions 

e Amount of data to be sent and received 
e RU sizes 

e Type of pacing on adjacent nodes 

e Node type (end node or network node) 


¢ Number of end nodes supported 
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¢ Non-SNA communications 

e Other OS/2 programs. 
Networking Services/2 will use adaptive pacing whenever possible to make the 
best use of the memory available to it. Here are some suggestions to assist in 
estimating the amount of memory a PS/2 should have for running Networking 
Services/2 when adaptive pacing is used (the adjacent nodes are NS/2 nodes or 
AS/400s) and RU sizes of 2KB to 4KB are used. For more information on esti- 
mating memory requirements for OS/2 see the OS/2 System Administrator’s 


Guide. These estimates should be added to the estimates for the rest of the 
system. 


1. Add 1.8MB of storage for APPC/APPN communications to start with. 


2. For each 75 end sessions (the LU is in this workstations) or 100 intermediate 
sessions (this is an intermediate routing node for these sessions) add an 
additional .5MB for NS/2 (this does not include application data buffers). 


3. Network Nodes should add an additional 1MB for every 32 end nodes being 
Supported. 


These storage suggestions are without any other concurrent running programs. 
You should add requirements for other concurrent programs to these numbers. 


Here is an example of an end node: 


An end node supporting 15 concurrently active end point sessions. 


0S/2 EE 3. OMB 


Communications 2.5MB 
Manager and NS/2 


15 End Sessions Q.1MB 


Total 5. 6MB 


Here are some examples for network nodes: 


A network node supporting 32 end nodes and up to 300 concurrently active inter- 
mediate sessions. 


0S/2 EE 3. OMB 


Communications 2.5MB 
Manager and NS/2 


32 End Nodes 1.0MB 


Supported 

300 Intermediate 1.5MB 
Sessions 

Total 8.0MB 
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A network node supporting 64 end nodes and up to 500 concurrently active inter- 
mediate sessions. 


OS/2 EE 3. OMB 


Communications 2.oMB 
Manager and NS/2 


64 End Nodes 2.0MB 
Supported 
500 Intermediate 2.5MB 
Sessions 
Total 10.0MB 


A network node supporting 128 end nodes and up to 1000 concurrently active 
intermediate sessions. 


0S/2 EE 3. OMB 


Communications 2.oMB 
Manager and NS/2 


128 End Nodes 4.0MB 
Supported 


1000 Intermediate 4.0MB 
Sessions 


Total 14.5MB 


Processor Recommendations 


An OS/2 system can be a Networking Services/2 end node. For network nodes 
that are going to be doing intermediate routing it is suggested that you use an 
80386-based processor. If you are going to fully load the network node with 128 
end nodes it is recommended that you use an 80486-based processor. 


3.2 Software Requirements 
Before you can install Networking Services/2 you must have: 
1. OS/2 EE 1.2 or 1.3 installed on your machine 
2. The Communications Manager installed 
3. APPC configured and installed. 


APPC is installed if the APPC.DLL file is in your C:\CMLIB\DLL directory or if 
there is a C:\CMLIB\APPN directory, which would mean that Networking 
services/2 has been previously installed. 


lf APPC is not installed, please read “Installing and Configuring APPC” on 
page 23 for instructions on how to install it. 


4. If your workstation is on a LAN, the LAN must be configured and installed. 
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This means that the Communications Manager has added a line 
“DEVICE =C:\CMLIB\LANDD.SYS” where C: is the disk letter where Commu- 
_ hications Manager was installed. 


Specifying IBMTRNET, IBMPCNET, or ETHERNET when installing the Commu- 
nications Manager will insert the line and copy LANDD.SYS to C:\CMLIB. 


3.3 Planning Considerations 
| | _ As with any communications network, planning is key to an efficient APPN 
network. There are several things to keep in mind while planning your network. 


Dedicated Network Nodes 
| Networking Services/2 does not restrict network nodes to network activities only. 
An end user can also be using that workstation. This might be fine if the 
network node is only providing a directory service for end nodes (for instance on 
a token-ring LAN). If, however, the network node is being used for intermediate 
session routing, the time slicing of OS/2 turns out to be rather disruptive to a 
human.user and should probably be avoided. 


Network Names 


All of the nodes in the APPN network must have the same NETID. Two nodes 
will only communicate if they have the same NETID unless they go though an SNI 
gateway. You will want to make sure all your APPN nodes specify the same 
NETID. — 


Control point names and connection network names are a part of the NAU name 
space and in places will need to unique among NAU names (including LU 
names) within the network. All NAU names must be unique within the network. 


3.4 Definition Considerations 


Partner LU Definitions — 


- Without NS/2 on the workstations you need to define every partner LU on every 
workstation even if the workstation is attached to an NS/2 network node. If you 
make the workstations NS/2 end nodes you do not need to define any partner 
LUs on the workstations if your transaction programs specify fully-qualified LU 
names for the partner when they do the attach. If they will be specifying aliases, 
then the partner LUs will still have to be defined. So, if at all possible, you want 
the TPs to specify fully- qualified LU names. 


Partner Location 


A network node is responsible for determining the location of the partner LU. If 
the workstations are not NS/2 end nodes then at the network node you will have 

~ to define what LUs are on each workstation. If the workstations are NS/2 end 
nodes, however, the network node will dynamically learn what LUs are on the 
end nodes. The subarea, unfortunately, is seen as a LEN node so you have to 
define on the network node every LU you want to communicate with in the 
subarea. This is where a WILDCARD can help you. The WILDCARD in effect 

_ says if it isn’t found anywhere else, it is across this link. Of course typos or 
non-existent LUs will be “found” across that link and a BIND will be sent into the 
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subarea. A little structuring of your LU names; however, might allow you to use 
partial WILDCARDs. A partial WILDCARD allows you to request to send anything 
that starts with “sub” across this link if you don’t find it anywhere else. Partial 
WILDCARDs are definitely preferable over full WILDCARDs so structure your LU 
names to be able to use them if at all possible. 
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Chapter 4. Installation Procedures 


In this chapter we will briefly describe the installation and the deinstallatior of 
Networking Services/2. 


4.1 Installing Networking Services/2 


This section is intended to augment the installation guide. 


Installing and Configuring APPC 


First review Chapter 3, “Planning Considerations” on page 17 if you have not 
already done so and verify that you have met the requirements for installing Net- 
working Services/2. 
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If APPC is already installed (APPC.DLL is in C:\CMLIB\DLL\) then go to “Con- 
ducting the Installation of Networking Services/2” on page 24. 


We assume that Communications Manager is installed in your machine. If not 
refer to the OS/2 Extended Edition/installation Guide. 


Go to the Communications Manager Primary Menu and add APPC definitions to 
your current configuration file (here we call it CONFIG.CFG): 


1. From the Communications Manager Primary Menu, do the following: 


Select Advanced 
Select Configuration... 
Keep your current configuration file (CONFIG). 


In the Communication Configuration menu specify the proper DLC 
parameters in the required DLC profiles. 


2. Select SNA feature profiles 


3. Create the required SNA Data Link Control (DLC) profiles... 


Create dummy profiles for: 


a. 
b. 


C. 


SNA Base profile 
A local LU profile (APPC logical unit (LU) profiles...) 


A partner LU profile that uses the SNA link defined in your SNA DLC 
profile (APPC partner logical unit profiles...) 


. A mode profile for the partner LU profile (APPC transmission service mode 


profiles...) 


. A session limit profile for the mode profile (APPC initial session limit 


profiles...) 


For a dummy profile give any name (LU, PLU, Mode, ISL for example) and 
just use the default values. These profiles will be ignored so there is no 
reason to make them correct. Be sure to press Enter on every screen; if 
you press ESC the profile will not be created. 


4. Verify the configuration file and fix any major problems. 


5. Reinstall the Communications Manager as follows: 
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a. Have your OS/2 EE diskettes ready to be inserted into the diskette drive 
when requested 


b. Under the OS/2 Command Interpreter type: reinst 


c. In the Communications Manager Install menu select: user configuration 
files and features | | 


d. On the next screen type: C:\CMLIB 
e. Select your own configuration file (we call it here CONFIG) 
f. You are back in the Communications Manager Install menu: press F3. 


When you are finished, verify that APPC is actually installed. You must check in 
your C:\CMLIB\DLL directory to see if you now have the APPC.DLL file. 


Conducting the Installation of Networking Services/2 


24 


After you have checked all items to install, stop the Communications Manager if 
it’s running. This also includes stopping all 3270 sessions and any programs that 
use the Communications Manager (such as Networking Services/2 if it was 
already installed). Insert the first diskette in the A: or B: drive and type the fol- 
lowing command at the OS/2 full-screen command prompt: 


A:\ INSTALL 
or 
B:\ INSTALL 


The INSTALL command will migrate your default configuration (.CFG) file built 
under the Communications Manager. If you do not have an SNA Network Name 
specified, the migration will fail. The Network Name is specified under the SNA 
Base profile under SNA Feature profiles in the Communications Manager config- 
uration. Be sure that you have the installation program migrate your current 
configuration (.CFG) file; otherwise, the Communications Manager will fail to 
start. You will also have to migrate any other Communications Manager config- 
uration files prior to using them with Networking Services/2. 


When you arrive at the IBM* panel presentation, press Enter to continue. 


Read the new panel and remember: 
e Press ESC to go back to the previous panel. 
e Press F1 to request additional help information. 


e Press F3 to exit the installation program. 


Select which parts to install. If you are new to Networking Services/2 select Both 
of the above (what we are assuming you will do in this sample installation). 


Type the name of the file where you want to save your CONFIG.SYS, since 
CONFIG.SYS will be modified by the installation. 


You should leave the default directory C:\CMLIB\APPN for the sample programs 
and high-level language header files when prompted. 


A panel will describe the directory tree where the files will go. 
You will now be prompted to remove and insert the diskettes. 


When you are prompted to create a .CF2 file, select YES. 


Networking Services/2 


The last panel reminds you how to reboot after the installation program is com- 
plete (when you have come back to your OS/2 window): 


1. Remove the installation diskette. 

Go to the Desktop Manager. 

Select Desktop option. 

select Shutdown. 

Reboot the system by pressing Ctri+Alt+ Del. 


a aS 


After you have installed it, the Desktop Manager will have been changed and a 
new option appears, called: IBM SAA Networking Services/2. 


eel Utilities 


a User Profile Management Se 


ES Introducing OS/2 
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Figure 2. Desktop Manager Window 


If you double-click on IBM SAA Networking Services/2, the following window 
appears: 
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Figure 3. Group - IBM SAA Networking Services/2 Window 


Completing the Installation 


After you finish the installation and if you installed the Networking Services/2 
with the option to install the samples program, you must have them in the fol- 
lowing subdirectory: 


C:\CMLIB\APPN\ SAMPLES 
Each sample program is contained in a subdirectory that matches its name. 


To be able to use each one easily, either define its path in the CONFIG.SYS, or 
copy the files .EXE to another subdirectory defined in the path statement of your 
CONFIG.SYS. 


The best way is to copy each .EXE in the subdirectory C:\CMLIB\APPN\SAMPLES and 
then define this subdirectory in the path statement of the CONFIG.SYS. 


You may change the order of the subdirectories in the path statement BUT be 
sure that the C:\CMLIB\APPN\ subdirectory stays BEFORE (on the left of) the 
C:\CMLIB\ subdirectory. 


4.2 Removing Networking Services/2 
You may remove Networking Services/2 by doing the following: 


1. Stop the Communications Manager if it is running. You’ll need to insert the 
first installation diskette and type at the command prompt A:\INSTALL\STOPFM. 
STOPFM is a program that terminates a process running on behalf of the 
frame manager. Presently it is not terminated as part of stopping the Com- 


26 = Networking Services/2 


munications Manager. Without running STOPFM, you can’t erase 
CMKFMSMLEXE from the CMLIB\APPN subdirectory or CMKFMAPI.DLL from 
the CMLIB\APPN\DLL subdirectory. 


2. Delete all files in the subdirectory \CMLIB\APPN and any files in subdirecto- 
ries within \CMLIB\APPN. To delete the file BLDLEVEL.APN you'll need to 
use ATTRIB. Type in the following: ATTRIB BLDLEVEL.APN -R. This will change 
it from read only. 


3. Copy all DLLs in the \CMLIB\CMBACKUP subdirectory back into \CMLIB\DLL 
subdirectory and copy ACSAPLDR.EXE from the \CMLIB\CMBACKUP subdi- 
rectory back into the \CMLIB subdirectory. You can then remove the 
\CMLIB\CMBACKUP subdirectory and its contents. 


4. Remove changes to CONFIG.SYS: 
e In path statements subdirectories \CMLIB\APPN and \CMLIB\APPN\DLL 
e In SET HELP statement subdirectory \CMLIB\APPN 


¢ In DEVICE statements for \CMLIB\APPN\ACSLDLAN.SYS and 
\CMLIB\APPN\CMKFMDD.SYS 


5. You will need to reboot to make the CONFIG.SYS changes take effect. 


6. After you have finished removing NS/2. the Group - IBM SAA Networking 
services/2, is still in the Desktop Manager. To remove it you must first 
double-click on it, then delete all options (programs) from the GROUP - IBM 
SAA Networking Services/2 window and then delete the group from Desktop 
Manager. 


4.3 Starting and Stopping Communications Manager and Networking 


Services/2 


When you start Communications Manager with a .CFG file, in which APPC is con- 
figured, Networking Services/2 will automatically activate the APPN configuration 
contained in the .CF2 that has the same filename as the .CFG. 


You can use Communications Manager with a .CFG in which APPC its not config- 
ured, only if it merely contains NetBIOS or X.25 without APPC definitions. Other- 
wise you can’t use a .CFG that was not migrated. 


When Communications Manager is stopped, you can still use the utility programs 


migration and verification, but there is no active APPN configuration. Your work- 
station is not considered a node. 
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Chapter 5. Configuration Procedure 


In this chapter we will discuss the necessary configuration files for NS/2 and how 
to build them. 


5.1 The Configuration Files 


Communications Manager uses one configuration file whose extension is .CFG. 
This file is located in the C:\CMLIB directory. With Networking Services/2 you 
still need the .CFG since you still use the services of Communications Manager. 


Furthermore, Networking Services/2 uses the DLC, gateway, 3270 LU, and LUA 
information of the .CFG file for its own purposes. 


However, Networking Services/2 also uses its own binary file whose extension is 
.CF2. This file is used at startup to configure the workstation as a node. If you 
modify this binary file while running Networking Services/2, it will have no effect 
until you stop and restart Communications Manager, except if you specify to 
update the current configuration that runs in the machine with the new modified 
.CF2. 


To build the .CF2 file you need an ASCII file, the Network Definition File, with an 
.NDF extension. Both the .CF2 file and the .NDF file are located in the 
C:\CMLIB\APPN directory. 


The .NDF file contains the verbs needed to configure Networking Services/2. 
These verbs replace any SNA configuration that was done in the SNA Feature 
Profile under Communications Manager. In fact, Networking Services/2 ignores 
most of the configuration done under the SNA Feature Profile and relies upon 
what is in the binary .CF2 file that was built from the ASCII .NDF file for config- 
uration. 


That means that once you have installed Networking Services/2, you should 
never change the following parameters in the SNA Feature Profile under Commu- 
nications Manager: 


1. SNA base 

. LU (except 5250 emulation) 

. Partner LU (except 5250 emulation) 

Modes (except 5250 emulation) 

. Initial session limits (except 5250 emulation) 
. Transaction programs 

. Conversation security. 


NOOB WP 


But you still have to use the SNA Feature Profile for: 


1. DLCs 
2. LUA 
3. LUs, partner LUs and modes used for 5250 emulation. 


The last file used by Networking Services/2 is the .SEC file. This file contains the 
binary security configuration. You never have to do anything with this file. 


Note: 
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Only .CFG and .CF2 are actually used by Networking Services/2. The 
.NDF is merely a way of building a .CF2 file. 


The .CFG file is still used for everything that is not defined in the SNA 
Feature Profile. 


The .CFG, .NDF, and .CF2 files must have the same name. 


To dynamically register a new .CF2 file you have to specify an option 
when you verify the .NDF file (see “The Utility Programs” on page 31). If 
you use the Presentation Manager panels, you will be prompted for a 
dynamic update of your current configuration. 


5.2 How to Build Your Configuration Files 


Getting Your First .NDF File 


The first time you build your ASCII node definition file, NDF, you may be in one 
of the following situations: 
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1. You had previously made APPC definitions in the Communications Manager 


.CFG file that you want to use to build your .NDF file. Then you will have to 
migrate your current .CFG file (this is the option that is proposed when you 
run the installation). 


The APPNMIG program is intended for this purpose. It can be used from an 
OS/2 session or through the Presentation Manager interface by selecting 
Migrate Configuration. Once you have migrated, you may want to modify 
some definitions in your .NDF file. To do that either use the Presentation 
Manager interface or edit your .NDF file. 


. You have no previous APPC definitions in the .CFG file that you want to use. 


If you want to configure your workstation as an end node, you only have to 
select Create/Quick Configuration in the Networking Services/2 window 
under Presentation Manager. Otherwise, you must first configure APPC in 
the .CGF file as explained in “Installing and Configuring APPC” on page 23, 
and migrate it to an .NDF file. Then you may erase this .NDF file and create 
a new one with your editor. Or you may edit this .NDF file and erase all that 
follows the first ”;” and use the Presentation Manager interface (which is 
much easier) by selecting Configuration Management (see “Creating Your .NDF 
File” on page 36). 


In both cases the migration utility builds a .CF2 file from your new .NDF file. 


Some verbs and parameters are not provided through the Presentation Manager 
interface and you may have to go into the Presentation Manager interface built 
.NDF file with an editor to add these definition verbs and parameters. 6.5, “What 
Is Not Supported by the Presentation Manager Interface” on page 54 explains 
which verbs are not supported by the Presentation Manager interface. 


When building or modifying your ASCII node definition file with your editor, use 
the file APPNV.CTL in C:\CMLIB\APPN\ as a template. It is an example of all the 
verbs and their parameters. This file is reproduced in Appendix A, “File 
APPNV.CTL” on page 191. 
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Networking Services/2 System Management Programming Reference provides a 
complete description of every parameter. 


The Utility Programs 
The following are the four most important programs that you need to know 
about. Each of these programs can be invoked by typing its name on the OS/2 
Command Interpreter or by selecting it on the Presentation Manager interface. 


APPNMIG 

APPNMIG is a program that extracts the SNA information from a Communi- 
cations Manager-built .CFG file and builds the Networking Services/2 .NDF and 
.CF2 configuration files. So if you already have the Communications Manager 
configured for any SNA functions you can run APPNMIG against your .CFG file. 
It will build the configuration files you need to start running Networking 
Services/2. The installation procedure automatically runs APPNMIG against the 
configuration file of your choice. 


The syntax of APPNMIG is: APPNMIG filename where filename without a file 
extension is the name of the .CFG file built by the Communications Manager. A 
useful option of APPNMIG is /r, which allows you to replace both old .NDF and 
.CF2 files. 


You can invoke APPNMIG by clicking on Migrate Configuration in the Networking 
Services/2 window under Presentation Manager. 


APPNC 
APPNC allows you to build the .NDF and .CF2 files through a Presentation 
Manager interface instead of using an editor. 


You can invoke APPNC by clicking on Change Configuration in the Networking 
services/2 window under Presentation Manager. 


APPNV 

APPNV is the program that reads the ASCII .NDF file and verifies that all verbs 
are in order and parameters are correct and consistent. It also checks the 
binary .CFG file on the \CMLIB directory to verify that Networking Services/2 is to 
be started when the Communications Manager is loaded. In other words, it veri- 
fies that the Communications Manager calls ACSAPLDR.EXE, which is the 
program that loads Networking Services/2. 


APPNV uses the file APPNV.CTL when verifying parameter and verb names. 
Look in APPNV.CTL for parameter and verb names if you get an error while 
running APPNV. 


The output from APPNV is the binary file with a file extension of .CF2. This is the 
file that Networking Services/2 uses during startup. 


When starting APPNV, you give the name of the ASCII file. When it goes to look 
in the .CFG file, it will be looking for it under the same name as the .NDF file. 


The syntax of APPNV is: APPNV filename where filename without a file extension 
is the name of the .NDF file and the corresponding .CFG file. A useful option of 
APPNV is /e, which allows APPNV to update the current configuration used by 
the workstation. 
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Refer to the APPNV.DOC file in the \CMLIB\APPN subdirectory for more informa- 
tion. 


You can invoke APPNV by clicking on Verify Configuration in the Networking 


- Services/2 window under Presentation Manager. 


APPNRST 

APPNRST creates an ASCII .NDF file from an existing binary configuration file 
.CF2. This is useful if you only have the .CF2 file and want to modify your config- 
uration. 


The syntax of APPNRST is: APPNRST filename where filename without a file 
extension is the name of the .CF2 file. 
Note: 


APPNMIG and APPNV accept all their parameters when being used under 
Presentation Manager. 


Except for APPNC these programs have online help facilities that give 
both syntax and options. For help, type the name of the program under 
the OS/2 Command Interpreter. 
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The Presentation Manager interface of Networking Services/2 is simple to use 
and powerful. It allows you to build the definitions of the .NDF file. However, in 
some cases (listed in section 6.5, “What Is Not Supported by the Presentation 
Manager Interface” on page 54) you will have to complete your .NDF file by 
editing it. 


You may use the Presentation Manager panels without having Communications 
Manager running (for example, to modify an .NDF file or create a .CF2 file). 


If Communications Manager is required to be running for some operation, you 
will receive an error message requesting that it be started. 


6.1 The Group - IBM SAA Networking Services/2 


The window in Figure 4 on page 34 is the entry point of Networking Services/2 
when using Presentation Manager. It allows you to: 


1. Define or change a configuration: 
a. Change a configuration file: 


- Links with neighbors 

- Advanced SNA characteristics (previously defined in the SNA 
feature profile under Communications Manager) 

- APPN node characteristics 


b. Manage the subsystem by: 


- Activating or deactivating links 
- Displaying the active configuration 


c. Display a configuration log file 
. Quickly configure a node as an end node attached to a network node 
. Migrate a Communications Manager configuration file 
. Verify a node definition file (.NDF file) 
Format a Communications Manager trace 


start or stop a Communications Manager trace 


NO mM Rw LD 


Display the active configuration (same option as 1.c above). 
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You can select what you want to do from the Group - IBM SAA Networking 
Services/2 window: 


Create/Quick Configuration 
: 058 Migrate Configuration 
"Verify Configuration 
€@ | Display Active Configuration 


| Sta fStop CM Trace 


E Ese Format CM Trace 


Figure 4. Group - IBM SAA Networking Services/2 Window 


There are three kinds of windows that can be invoked from this window: 


e Selection windows (Configuration Management and Create/Quick Configura- 
tion) 

e Entrywindows (Migrate Configuration, Verify Configuration, Format CM Trace, 
and Start/Stop CM Trace) and 

¢ Display windows (Display APPC/APPN Parameters). 


6.2 The Configuration Management and Create/Quick Windows 


The Create/Quick Configuration window entrywindow is very similar to the 
entrywindows in the Configuration Management window. Moreover, once you 
have made your quick configuration, a pushbutton allows you to go to the Config- 
uration Management window. Therefore, we will now discuss the Configuration 
Management window, but if you are only interested in the Create/Quick Config- 
uration window refer to “Filling the Entryfields of a Window” on page 41. 
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Figure 5. Configuration Management Window 


First, notice that the title of this window is “Networking Services/2 - 
XXXXXXXX.NDF” where XXXXXXXX is the name of the .NDF file that you want to 
configure. It can be different from the name of the .CF2 file your workstation is 
using. While this XXXXXXXX.NDF file is in use by this window, you cannot edit it 
or use it with any other program. 


If you have updated a configuration and you want to see the result in the .NDF 
file without exiting the Configuration Management window, you must open 
another .NDF configuration file (if you have one) by selecting File -> Open in the 
action bar. Then you can view the .NDF file with any editor. 


To use the Configuration Management window, first select an item in the presen- 
tation space then choose an option in the action bar of the window. 


Another way of using this window is to double-click on the item; you will get a 
window that prompts you for the action you want to perform. These actions are 
the same as those you can get with the action bar (see Figure 6 on page 38). 


Once you have selected an item in the presentation space you will see that the 
options in the action bar are not all available. Furthermore, the same option in 
the action bar may have a different pull-down, depending on the item selected in 
the presentation space. 


Figure 5 shows the Configuration Management window with Configuration File 
selected. In that case, the contents of the first two pull-downs are: 


File Configure 
Open Connections 
Verify Advanced SNA 
Save Local Node Characteristics 
Save as 
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No matter which selection is made in the presentation space, three choices on 
the action bar will always be available: 


View Options Help 
Text Smal] font Help for help... 
Icon Large font Extended help... 


Keys help... 
Help index... 
Task Help... 
About... 


Selecting Configuration File in the Configuration Management Window 
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This selection allows you to build or modify an .NDF file and the corresponding 
.CF2 file. Therefore, Communications Manager does not need to be running. 


The rest of this section will describe: 


e How to create and save .NDF files 

¢ How to configure an .NDF file 

e How to use the windows that offer selections 
e How to fill the entrywindows. 


Creating Your .NDF File 

We will now see how to create an .NDF file from any .CFG. Then we will explain 
what you have to do to create a new .NDF file that uses a .CFG already used by 
another .NDF file. Once your .NDF is created you will have to configure it. The 

section “Configuring an .NDF File (Overview)” on page 38 gives an overview of 

the configuration process, whereas chapter Chapter 7, “Sample Configurations” 
on page 57 explains how to configure each type of node. 


How to create an .NDF file from any .CFG file: 
You can migrate a .CFG file without Communications Manager running. 


If your .CFG file contains APPC definitions, migrate it. If you don’t want to keep 
the APPC definitions you have migrated, edit the .NDF file, delete all that follows 
the first ’;” and save it. 


If your .CFG file does not contain APPC definitions, configure APPC as explained 
n “Installing and Configuring APPC” on page 23. Then migrate it, edit the NDF 
file, delete all that follows the first ”;” and save it. 


Creating a new .NDF with the same .CFG definitions: 


Once your .CFG file is migrated you have an .NDF and a .CF2 with the same 
filename. But you may wish to use another APPN configuration still using the 
same definitions for all that is not in the SNA Features Profiles of Communi- 
cations Manager (for example if you want to do some testing). 
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Here is how to do it very quickly (we assume that your old configuration files 
have the filename “old” and you want to give the filename “new” to your new 
configuration files): 


1. Issue the following commands under the OS/2 Command Interpreter: 


e In C:\CMLIB\ : copy old.* new.* 
e In C:\CMLIB\APPN\ : copy old.* new.* 


2. Edit new.NDF and delete all that follows the first ”;” 


3. Configure your new configuration as explained below. 


Saving an .NDF File 

In all cases you actually save all your changes in the .NDF file only when you 
select Verify, Save, or Save as in the File pull-down of the action bar in the Con- 
figuration Management window. 


When you have made some definitions or changes in the Advanced SNA window 
or in the Connections window, you may either save or verify the .NDF without 
closing these windows or close these windows to be back in the Configuration 
Management window. In both cases you have to use the File pull-down menu in 
the Configuration Management window. 


When you select Save in the Configuration Management window you receive a 
warning panel because you have not verified your file, but your .NDF file will be 
saved. So select Yes to continue with the close if you don’t want to verify your 
saved .NDF file. 


When you select Verify in the Configuration Management window and the verifi- 
cation is successful the .NDF and .CF2 files are created. If the file you are 
working on has the same filename as the currently used configuration, then you 
can update the current configuration with your modifications. You merely have 
to press the Update pushbutton that appears in this case. However, be careful: 
there are some modifications that cannot be used to update the current config- 
uration. So, after updating the current configuration, examine the .LOG file to 
see if there is any warning. If you have any doubt, stop and restart Communi- 
cations Manager. 


No dynamic updates to your running configuration are applied to anything active 
in your configuration. In some cases, the information affected by the dynamic 
update will be made pending the completion of a running TP or session. For 
example, when you change something for a mode, it creates a new mode defi- 
nition. However, this mode definition will not go into effect until all the sessions 
started under the old definition have been terminated. 
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Configuring an .NDF File (Overview) 
The title of the window contains the name of the .NDF file that you intend to 
modify. 


= Networking Services/e - one: NDF 7 
File Configure sehsysters mien eae ¢ View Options Hel 
Networking Services/2 a. Aen” 
Active Configuration File: FPRALY 


| © Configure Connections... 


| © Configure Advanced SNA... 


Configuration 


| © Configure Local Node Characteristics... 


| © Open Configuration file... 


| Verify Configuration file 


: © Save Configuration file 


ae save Contiguration file as... 


Figure 6. Configuration Management Window 


Figure 6 shows the Configuration Management window when you double-click on 
Configuration File. The list box presents the same choices as can be selected 
with the action bar. 


If you want to work with another file, select File in the action bar and Open... in 
the pull-down. A window will prompt you to choose the .NDF file you want to 
modify. 


Once you have selected the .NDF file the system parses both the .NDF and the 
.CFG files. If there are errors, they will be logged in the .LOG file, which you can 
examine by selecting Configuration Log in the same window (see “Selecting 
Configuration Log File in the Configuration Management Window” on page 43). 


To configure your network definition file select Configure on the action bar. 


From the pull-down menu select: 
Connections to define links with (if you are a network node): 


- Network node 
- End node 

- LEN node 

- Primary host 


or with (if you are an end node): 


- Network node 
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- Peer node 
- Primary host 


Advanced SNA to define: 


- Transaction programs 

- Transaction program defaults 

- Transaction program security 

- Partner LUs 

- Local LUs 

- Conversation security 

- LU to LU security (LU to LU password) 
- CPI-C side information (for any PLU) 

- Modes 


Local Node Characteristics to define: 


- Node name 

- Network name (netid) 

- Node ID 

- Alias 

- Type (end node or network node) 

- Activate attach manager at startup. 


Examples of configuring nodes are given in Chapter 7, “Sample Configurations 
on page 57. See especially “Building the Node with the Presentation Manager 
Screens” on page 64 where many definitions are made. 


Note: 


If you want to define a LEN node, use “End node” in the Local Node Cha 
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acteristics. Then connect your node with other nodes by choosing ”Peer 


node” in the Connections pull-down menu; a LEN node ts an end node 
without CP-CP sessions with its neighbors. 


In the whole APPN network you may have only one connection to a 
“primary host”, that is, a host that contains a focal point to manage the 
network (such as NetView). 


In other cases, when you want to go through a subarea network or defin 


a connection to a host that contains LU 6.2 LUs, use the connection to a 
“LEN node”. 
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Defining or Modifying Items in a Window 

Usually you have to first select an item in the presentation space of the window 
and then to act on this item, either by double-clicking on it or by choosing an 
option in the action bar of the window. 


Some windows use a presentation similar to the one used in the main window of 
the File Manager: 


f+ Transaction Program Definitions 
~~ Transaction Program Defaults 
Transaction Program Security 
Partner LUs 
LU Name: Alias: : 
USIBMRA.HENRILUT =HENRILUI Created | 
‘MUSIBMRA.RALYOS2A “RALYOS2A - Created? 


Local LUs 

Conversation Security 

LU to LU Security 

CPI Communications Side Info 


Figure 7. Advanced SNA Window 

In this window "Transaction program”, ’Transaction Program Defaults”, and 
“Conversation Security” are items, whereas “USIBMRA.HENRILU1...” and 
“USIBMRA.RALYOS2A...” are sub-items of the item ”Partner LU”. 


Note that items cannot be deleted. Only a sub-item, if any, can be created, 
changed, or deleted. 


Here are the meanings of the signs you may find in front of an item: 


+ Means that you can expand this item by clicking on the sign ”+” . 
Thus you will view all the sub-items of this item and a ”-” will replace 
the “+”. 

- Means that this item is expanded; you can collapse it by clicking on 


the *-” anda”+” will replace the ”-” . 


: Means that this item cannot have sub-items. When you double-click 
on it you go to an entrywindow. 


If no sign precedes the item, it does not contain any sub-item, but you 
may define some. For example, if you have not defined any pariner 
LU, there will be no sign in front of the item “Partner LU”. 


To create a sub-item, double-click on the item. You will go in an entrywindow. 


To change a sub-item, double-click on it. You will go in an entrywindow. 
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To delete a sub-item, select it and then use Delete in the Edit option of the 
action bar. 


You can also select and use the Edit option to create or change a sub-item but 
that takes more time. 


Filling the Entryfields of a Window 

For those windows that require the user to type in information, the information to 
be typed is always very simple. For help, place the cursor on the field you want 
information about and select the help pushbutton or press F1. 


To move the cursor from one field to another use the TAB key. 


Don’t worry about the length or syntax of what is to be typed, since it is imposed 
by the presentation of the windows. If you cannot type a character, check with 
the help facility. 


Be warned that many fields are case sensitive. Check with the help facility. 


Some fields are marked “(optional)” but very often you must fill them if you want 
to add more information. For instance, if you create a connection to a LEN node, 
you must fill the Partner Network Name and the Partner Node Name to be 
allowed to use the pushbutton Define Partner LUs. 


Whenever a default name is proposed, replace it with a more significant name in 
your configuration. For example, replace LINKO001 by LNNBB118 if this link 
leads to the network node in room BB118. 


You can always cancel what you are defining by clicking on Cancel or closing the 
window. 


When you have finished completing the fields, click on OK to validate or continue 
to the next window if you have to (in which case use a pushbutton whose name 
ends with: ...). 


Selecting APPN in the Configuration Management Window 


This allows you to manage the links and to display the active configuration. 
Therefore, Communications Manager needs to be running. 


The only selectable action on the action bar is “Subsystem Management.” 
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ein Services/? status: Active 
Active Configuration File: FPRALY 


Figure 8. Configuration Management Window when You Double-Click on APPN 


The option “Display Active Configuration...” in the pull-down of Subsystem Man- 
agement is the same as “Display APPC/APPN Parameters” in the Group IBM 
SAA Networking Services/2 window. It is discussed in section 6.4, “The Display 
APPC/APPN Parameters Windows” on page 49. 


When you select Links... you will see a window that displays the defined links 
and their status. 


The action bar gives the following options: 


Change Status Display 
Activate Refresh 
Deactivate Hard Details 


Deactivate Soft 


Change Status allows you to activate or deactivate a selected link. After 
changing the status you must select Refresh to see the result. If the performed 
action requires some time to complete, the status will be pending active or inac- 
tivate as long as it’s not completed. 


Deactivate Hard will deactivate the link immediately. 


Deactivate Soft will deactivate the link once all the conversations using this link 
are terminated. : 
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Figure 9. Link Subsystem Management Window 


Selecting Configuration Log File in the Configuration Management Window 
Here Communications Manager does not need to be running. 


The only selectable action on the action bar is “File.” 
Select Open in the File pull-down menu (there is no other choice) and you will get 
a window with all the .LOG files. Open the one you want to see. The .LOG files 


contain information on warnings and errors registered during operations on an 
.NDF file, such as migration or verification. 
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6.3 The Migrate, Verify, Format, Start/Stop CM Trace Windows 


All these windows are Presentation Manager entrywindows, where you only 
have to type a filename and/or flags. 


When you use these windows, first fill in the entryfield and then select Open to 
activate the utility programs. An OS/2 window appears where you can follow 
what is happening. As soon as the program has ended, the title of the window 
will indicate “completed.” Then you must close the window yourself. 


Using the migrate and verify windows will update the .LOG file. 
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Selecting Migrate Configuration in the Group Window 
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CACMLIB\MAPPNiMIGRATE.CMD 


Enter CM configuration [.CFG] file name 


Figure 10. Migrate Configuration Window 


This window is intended to run APPNMIG (see “The Utility Programs” on 
page 31). 


Type the filename of your .CFG file followed by any needed flags. To get infor- 
mation about the flags, open the window without any parameters or type APPNMIG 
in a full-screen OS/2 session. 


The flag /r allows you to replace both .NDF and .CF2 when you migrate. 


Example: CONFIG /r 
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Selecting Verify Configuration in the Group Window 
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P 
2 | Configuration Management 
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Create/Quick 
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aaah Enter node definitions [.NDF] file name 


| @> Display Active} 


Figure 11. Verify Configuration Window 

This window is intended to run APPNV (see “The Utility Programs” on page 31). 
Type the filename of your .NDF file followed by any needed flags. To get infor- 
mation about the flags, open the window without any parameters or type APPNV in 


a full-screen OS/2 session. 


The flag /e allows you to update the current configuration with the configuration 
being verified. 


Example: CONFIG /e 
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Selecting Format CM Trace in the Group Window 


=) Group - IBM SAA Networking Se | 7 [= 


Program View Help _ 
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Pes Configuration Management 


CACMLIB\APPNIFMT TRACE.EXE 


Enter optional flags and trace [. TRC] file n: , 


Figure 12. Format CM Trace Window 


This window is intended to run FMTTRACE (see “The Format CM Trace Facility” 
on page 182). 


The optional flags can be grouped together (/sD is the same as /s /D). They must 
be typed in front of the drive, path, filename, and extension of your trace file. If 
not specified, the drive and path default to the current ones (C:\CMLIB\APPN\), 
and the extension defaults to .TRC. 


For information about the flags, open the window without any parameters or type 
FMTTRACE ? in a full-screen OS/2 session. 


The flag /D is recommended to get a detail file .DET. 


For example: /Ds C:\TRACES\TRACE 
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Selecting Start/Stop CM Trace in the Group Window 
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Program View Help View Help : i 
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CACMLIB\APPNICMTRACE.EXE 


Enter trace options 


Figure 13. START/STOP CM Trace Window 


This window is intended to run CMTRACE (see “The CM Trace Facility” on 
page 180). 


Four options can be entered from this panel: AutoStart, START, STOP, and COPY. 
For information about the syntax, open the window without any parameters or 
type CMTRACE ? in a full-screen OS/2 session. 


Autostart 
To allow the tracing of what is happening during the Communications Manager 
initialization, type AUTOSTART followed by the desired flags and their parameters. 


For example: 


AUTOSTART /api appe services 
/data ibmtrnet 
/event 5 12 
/storage 3 


You cannot deactivate the AUTOSTART without going into Communications 


Manager. It is easier to make it trace nothing by typing AUTOSTART without flags. 
The result is exactly the same. 
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Start 
To start a trace, type START followed by the desired flags and their parameter(s). 


You may either start all the categories you want at the same time or start them 
one after the other. For instance START /api appc followed by START /api 
services and START /event 5 12 is the same as START /api appc services /event 
O: ie: 


The recommended usage is: 


START /reset 
/api appc services 
/data ibmtrnet <- if you are using a token-ring LAN 
fevent 5 12 
/storage 3 


Stop 
To stop a trace, type STOP followed by flags and their parameters. 


The same considerations as above apply to the STOP command. If you merely 
type STOP you will stop tracing all categories. But it won’t stop the autotrace. 


Copy 
Once you have stopped tracing, your trace is not yet in a file. To copy the trace 
to a file, type COPY followed by the path of the file. 


The default directory is the current one (C:\CMLIB\APPN\). If you do not give an 
extension there will be no default and you won’t be able to format the file 
because, aS we saw just before, FMTTRACE will suppose that the extension is 
.TRC. Therefore, you should give .TRC as the extension. 


Example: COPY C:\TRACES\TRACE. TRC 


Where to Put the Traces 

The choice is simple: either you use the defaults and your traces will be in the 
C:\CMLIB\APPN\ directory, or you decide to store them in a specific place and 
each time you will have to type the full path in the CM Trace and the Format CM 
Trace windows. 


6.4 The Display APPC/APPN Parameters Windows 


The Display APPC/APPN Parameters window is intended to display the active 
configuration that is being used by the node. 


Unless you have specified the /e parameter when you ran the verification 
program it will not display changes made to the current .CF2 file since Communi- 
cations Manager was started. Your active configuration and your .CF2 file can 
be different. 


Your present .CF2 becomes your active configuration only if you verify the .NDF 


file with the /e option and you get no warning in the .LOG file or if you stop and 
restart Communications Manager. 
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Figure 14. Display APPC/APPN Parameters Window 


To use this program from an OS/2 command line, type PMDSPLAY. The action 
bar gives the following pull-downs: 


Display Options 
APPC Display to Screen 
APPN Display to File 
Exit Select Target 
Refresh 


To view APPC or APPN parameters, select Display from the action bar. In the 
pull-down menu choose APPC or APPN. 


_ Choose Select Target to view the active configuration of another workstation 
instead of yours. In the target workstation the program 
C:\CMLIB\APPN\SAMPLES\DISPLAY\RDSPSRVR.EXE must be defined as 
remotely startable: | | 


e Either add a TP definition for it in the .NDF file 


e Or use the DEFINE DEFAULTS verb in the .NDF file: put the parameter 
IMPLICIT INBOUND PLU_SUPPORT(YES) and give a 
DIRECTORY_FOR_INBOUND_ ATTACHES where you put this program. You 
may specify DIRECTORY _FOR_INBOUND_ATTACHES(*). That means this 
program will be looked for in the directories of the path statement in your 
CONFIG.SYS. 


The second choice is better. 


Choose Refresh to refresh the content of the display. 
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Selecting APPC from the Display Window 


When you select APPC you get the following pull-down menu: 


APPC 
Adapter 
Global SNA 
Link Definitions 
Links 
Logical Units 0 to 3 
Logical Unit 6.2 
LU Definitions 
Management Services 
Mode Definitions 
PLU Definitions 
Sessions 
SNA Gateway 
System Defaults 
Transaction Program Definitions 
Transaction Programs 
X.25 Physical Links 


Appendix B, “What PMDSPLAY Shows” on page 219 shows an example of what 
can be viewed with each item. 


The following lists only the most significant information for each selectable item. 


For more information, refer to the Networking Services/2 System Management 
Programming Reference. 


Adapter information includes: 
Number of adapters and their characteristics, including: 


DLC name, link station role, security, maximum number of link stations. 


Global SNA information includes: 
Machine model, version of softwares, network and CP names, CP alias, node ID, 
node type. 


Link definitions information includes: 
Number of defined links and their characteristics, including: 


Link name, adjacent node CP name and type, DLC name, adapter number, desti- 
nation address, CP-CP session support, preferred network node server (the adja- 
cent node), auto activate, transmission group number, limited resource (if you 
want the link to be activated only when there is a session), solicit SSCP session, 
init self, bind support, physical characteristics, security. 


Links information includes: 
Number of currently active links and their characteristics, including: 


Link name, DLC name, adapter number, destination address, state, adjacent 
node CP name and type, connection type, physical characteristics, security. 
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Logical units 0 to 3 information includes: 
Number of active LU 0, 1, 2,and 3 LUs and their characteristics, including: 


Access type (for example, 3270 emulation), LU type, local address, short and 
long names, LU-LU session ID, DLC name and adapter number, remote DLC 
address, SSCP-LU and LU-LU sessions state. 


Logical unit 6.2 information includes: 

Number of active local LU 6.2 LUs and their characteristics. A list of its partner 
LUs and their characteristics for each LU. A list of modes and their character- 
istics for each partner LU. 


LU definitions information includes: 
Number of defined local LU 6.2 and their name, alias, local address. 


Management Services information includes: | | 
Number of held MDS alerts, NMVT alerts, focal points, MS applications, active 
transactions. 


Mode definitions information includes: 
Number of defined modes and their mode name, class of service, parameters. 


You will find here the IBM-supplied modes and your own defined modes. 


PLU definitions information includes: 

Partner LUs that are currently known by the node. These are the partner LUs 
that you have defined in your .NDF file and the ones your node has learned 
about. 


Number of known partner LUs and their name, alias, uninterpreted name, 
maximum logical record send size, conversation security, parallel session 
support. 


Sessions information includes: | 
Number of active sessions and their characteristics, including: 


Session and conversation IDs, LU and partner LU alias, mode name, parameters, 
connection type (host or peer), conversation group ID, local and partner LU 
names, pacing type. 


SNA gateway information includes: 
Size of the gateway LU section, number of gateways, parameters for each one. 


System defaults information includes: 
Default mode name, local LU, implicit partner LU support (binds are accepted 
from undefined partners), defaults for TPs. 


Transaction program definitions information includes: 
State of attach manager, number of configured transaction programs and their 
definitions, including: 


Name, file specification, parameter string, synchronization level, conversation 
type, incoming allocate parameters, receive allocate parameters, transaction 
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program type, program state, conversation security information required, 
process ID, program type, remotely initiated, icon file specification. 


Transaction programs information includes: 
Number of active transaction programs, and for each: 


TP name and ID, where initiated, local LU alias, partner LU, number of conversa- 
tions for this TP and for each: 


Conversation ID, state (send, receive, ...), session ID, synchronization level, con- 
versation type. 


X.25 physical links information includes: 
Information defined in Communications Manager. 


Selecting APPN from the Display Window 


When you select APPN you get the following pull-down menu: 


APPN 
Class of Service 
Connection Network 
Directory 
Intermediate Sessions 
Node 
Topology 


Appendix B, “What PMDSPLAY Shows” on page 219 shows an example of what 
can be viewed with each item. 


The following lists only the most significant information for each selectable item. 


For more information, refer to the Networking Services/2 System Management 
Programming Reference. 


Class of service information includes: 
Number of classes of service known in the node and for each: 


Name, priority, number of node rows and TG rows, characteristics of each node 
row and each TG row. 


You will find here the IBM-supplied classes of service and your own defined 
classes of service. 


Connection network information includes: 
Number of connection network definitions and for each: 


Connection network name, physical characteristics, number connection network 
adapters; for each: adapter DLC name and adapter number. 


Directory information includes: 

Number of directory entries and of network node entries. For each network 
node: CP name and number of associated LUs. For each LU: name, owning CP 
name and type (“home’” if the network node CP entry is the same as the owning 
CP, “register” if the node is a network node and the LU is defined in an end node 
that belongs to the network node domain, “cache” if the node is a network node 
and the LU has been previously found through a search). 
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intermediate sessions information includes: | 

Number of sessions that go through the network node and for each: CP name of 
the adjacent node from which the bind came, CP name of the adjacent node to 
which the bind went, name of the link over which the bind was received, name of 
the link over which the bind was sent, fully-qualified procedure correlation identi- 
fier (FQPCID). 


Node information includes: 

Route additional resistance, maximum number of resources that can be cached 
in directory, current number of entries in the directory cache, number of updates 
before directory is saved. 


Topology information includes: 
Number of network nodes and for each: state, description of every TG that 
leaves the node. 


6.5 What Is Not Supported by the Presentation Manager Interface 
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The following cannot be defined with the windows: 


DEFINE_LOCAL CP parameters 
e Nau address (set to independent_lu) 


e Max_memory_segments (set to system limit) 


DEFINE _CONNECTION_NETWORK parameters 


e No support for the verb with the Configuration Management window 


¢ Connection network name is set to C&SM LAN ID for end nodes defined with 
the Create/Quick Configuration window 


DEFINE LOGICAL_LINK parameters 
¢ CP-CP session support (set to YES if connection to LEARN or NN and set to 


NO if connection to LEN) 


¢ Activate_at_startup (set to YES if connection to LEARN or NN and set to NO if 
connection to LEN) 


e« Limited resource (set to USE_ADAPTER_DEFINITION) 

¢ Link_station_role (set to USE_ADAPTER_DEFINITION) 

e Cost_per_connect_time (set to USE_ADAPTER_DEFINITION) 
e Cost_per_byte (set to USE _ADAPTER_DEFINITION) 

e Link_speed (set to USE_ADAPTER_DEFINITION) 

e Security (set to USE_ADAPTER_DEFINITION) 

e User defined 1 (set to USE_ADAPTER_DEFINITION) 

e User defined 2 (set to USE ADAPTER_DEFINITION) 

e User defined 3 (set to USE_ADAPTER_DEFINITION) 
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DEFINE _PARTNER_LU parameters 


e Partner_Lu_Uninterpreted_Name (set to binary zeroes) 


e Parallel session support (set to YES) 


* Max_mc_Il_ size (set to 32767) 


DEFINE _PARTNER_LU_LOCATION parameters 
e Wildcard entry (set to NO) 


¢ Fq_serving_nn_cp_name (set to binary zeroes) 


DEFINE COS 


e No support for this verb 


DEFINE_DEFAULTS parameters 
e Default_mode_name (set to “BLANK” mode name) 


e Inbound implicit_partner_lu_ support (set to YES) 
¢ Max_mc_Il_ size (set to 32767) 

e Default_tp conv_security_rqd (set to NO) 

¢ Max_held_alerts (set to 10) 


DEFINE_TP parameters 
e Conversation type (set to EITHER) 


e Sync_level (set to EITHER) 

* Queue depth limit {set to 255) 

¢ Incoming allocate_timeout (set to HOLD FOREVER) 
¢ Receive allocate _timeout (set to HOLD FOREVER) 


ACTIVATE_DLC 


e Generation based on configured adapters 


CNOS 
e No support for this verb. 
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Chapter 7. Sample Configurations 


An APPN network can be looked at like a puzzle: depending on what you need, 
you will take certain basic types of connectivity and put them together to build 
your network. In this chapter we will describe the following basic connectivity 
pieces in the APPN puzzle: 


1. End node obtained by migrating a .CFG file that contains APPC definitions 
2. End node configured for a direct peer connection with another node 
3. Network node connected to other nodes: 


e End node in its domain 

e End node out of its domain 

e End node defined with no CP-CP sessions (served by another network 
node) 

e End node with a network node defined as a backup server 

e Network node 


4. Connection network 
5. Network node acting as a bridge between two token-ring LANs 
6. Subarea network and APPN network: 


e Two parts of an APPN network connected through a subarea network 

e LU 6.2 in a subarea network enabled to have a session with an LU of the 
APPN network 

e Connection to a primary host (host that contains a focal point). 


For each of these basic pieces you will find the corresponding .NDF file. 


The last section of this chapter gives a complete description of how to build a 
sample APPN network. 


For more information about the verbs and their parameters, see Appendix A, 
“File APPNV.CTL” on page 191. You can find a detailed explanation of the verbs 
in the Networking Services/2 System Management Programming Reference. 


7.1 End Node Obtained by Migrating an APPC-Configured .CFG File 


Highlights 


We will first give some highlights on the migration process and then give an 
example of what you obtain when you migrate a .CFG file in which APPC is con- 
figured. 


You will find an overview of the process to follow to have your workstation fully 
participate in the APPN network. Then we will see what you must do before 
migrating. Finally, we will discuss the compatibility between migrated and non- 
migrated workstations. 
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How to Have Your Workstation Take Full Benefit of APPN | 
The migration of your configuration is intended to make your workstation partic- 
ipate in the APPN network as a LEN node. A LEN node does not implement the 
full capacity of APPN nodes. So, after the migration you should transform your 
LEN node into an end node or network node. 


To let it become an end node you have to define a link to a network node server 
as explained in section 7.7, “End Node in the Domain of a Network Node Server 
Defined with the Configuration Management Window” on page 75. To let it 
become a network node you have to define its type as being network node and 
then connect it to any network node or end node you wish as explained in 
sections 7.14, “Network Node Connected to Another Network Node” on page 86 
and 7.5, “Network Node Server of the Domain” on page 71. 


Once you have either an end node or a network node, you should delete the 
DEFINE PARTNER_LU_LOCATION verbs issued for the partner LUs that are in a 
network node or end node. Do, however, keep these verbs for every workstation 
that has not been migrated. The reason to delete these verbs is that with APPN 
you don’t have to define the partner LU’s location. With APPN, the location of an 
LU is dynamically found. 


What to Do before the Migration 
Here are the rules you must respect if you want your workstation to participate 
in an APPN network: 


« You must give a name to the network (also known as NETID). A blank name 
is not valid. 


¢ Each LU name must be unique within the network. 


e Consider that the PU name is an LU name and thus must be different from 
any LU name. This consideration may be ignored if you have kept the 
default PU name: PUOQOOOOO. 


e Consider as well that the C&SM LAN ID specified for the adapter in Commu- 
nications Manager under: 


SNA feature profiles 
Data Link Control (DLC) profiles... 
IBM Token-Ring Network... 


is an LU name and must be different from any LU name. 


Compatibility with Non-Migrated Workstations 

You do not have to migrate all of your workstations to Networking Services/2. 
The ones you migrate will keep the same capabilities they had before the 
migration. 


If two workstations used TPs to communicate before migration, they will still be 
able to communicate after the migration of one or both of them. No intervention 
is required on either machine. 


Since an end node obtained by migrating an APPC configuration file (.CFG) will 
not support CP-CP sessions with its neighbors, it is indeed a LEN node, as it was 
before the migration. From the Networking Services/2 point of view, migrating 
your node without changing anything in the .NDF makes no difference. 


Here we assume you have a .CFG file with Network ID, LUs, PLUs, modes, initial 
session limit, and transaction programs already defined. 


Networking Services/2 


Definitions in Your .CFG File 


Let’s suppose you have the following definitions: 


LAN feature profiles 
— Adapter 0 configured 
SNA feature profiles 
— SNA base profile 


- Physical unit (PU) name: CARLEY 

- Network name: USIBMMK 

- Node ID (in hex): 32222 

- Auto-activate APPC attach manager: Yes 


— Data Link Control (DLC) profiles... IBM Token-Ring Network... 


- Adapter number: 0 
- Free unused link: Yes 
- C&SM LAN ID: CARLEY 


— APPC logical unit (LU) profiles... 


- LU alias: FILEREQ 

- Comment: Sample APPC program LU for requester 
- LU name: CARLEY 

- Default LU: YES 

- LU local address (NAU address): 00 

- LU session limit: 255 

- Maximum number of transaction programs: 0 


— APPC partner logical unit profiies... 


- Partner LU (PLU) alias: FILESVR 

- Comment: APPC Sample programs 

- Fully-qualified PLU name: . LABQO001 
- LU alias: FILEREQ 

- Adapter/directory entry: 0 

- Destination address (in hex): 400030010020 

- PLU session limit: 15 sessions 

- Maximum mapped conversation logical record length: 32767 
- LU-LU session security: No 

- Conversation security: No 

- Conversation security verified: No 

- Permanent connection: No 

- Solicit SSCP session: No 

- Mode name: MODE1 

- Initial Session Limit: ISL 


— APPC transmission service mode profiles... 


- Mode name: MODE1 

- Comment: Model Transmission Service Mode (model only) 
- Minimum RU size: 256 

- Maximum RU size: 1024 

- Receive pacing limit: 8 

- Session limit: 10 


— APPC initial session limit profiles... 


- Initial session limit profile: ISL 
- Comment: Model Initial Session Limits (model only) 


Chapter 7. Sample Configurations 59 


- Minimum number of contention winners source: 0 
- Minimum number of contention winners target: 0 
- Number of automatically activated sessions: 0 


— APPC remotely attachable transaction program (TP) profiles... 


- TP profile name: FILESVR 

- Comment: Model Remotely Attachable Transaction Program (model 
only) 

- Service TP: No 

- TP name: FILEMSVR 

- TP filespec: C:\SAMPLE\FILECSVR. EXE 

- Sync level: Either 

- Conversation type: Either 

- Conversation security: No 

- TP operation: Non-queued - attach started 

- Queued allocates timeout: 480 

- TP receive timeout: 480 

- Max attach queue depth: 5 

- Program type: Background. 


Migration of Your .CFG File 
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To migrate this .CFG file you can: 


- Either select Migrate Configuration in the Group - IBM SAA Networking 
Services/2 window and enter the filename of this .CFG in the entry-window 
- Or type appnmig and the filename of this .CFG under the OS/2 Command 
Interpreter. 


On the screen will appear: 


Networking Services/2 Configuration Migration Utility V1.00 
(C) Copyright IBM Corporation 1990,1991. All Rights Reserved. 


Messages will be logged to the file 'C:\CMLIB\APPN\jeff.LOG'. 


Parsing of the Communications Manager configuration file started. 
Parsing of the Communications Manager configuration file was successful. 
Migration of the Communications Manager configuration started. 

Update of the node definitions file started. 

Update of the node definitions file was successful. 

Update of the security information file started. 

Update of the security information file was successful. 

Verification of the Networking Services/2 configuration started. 
Verification of the Networking Services/2 configuration was successful. 
Update of the Networking Services/2 configuration file started. 

Update of the Networking Services/2 configuration file was successful. 
Migration of the Communications Manager configuration was successful. 


Figure 15. What Appears on the Screen when You Migrate 

Four files are created with the filename of the configuration file and file exten- 
sions of: .LOG, .NDF, SEC, and .CF2. The first two files are in ASCII format and 
can be viewed or edited. 


The .LOG file contains the description of the operation: 
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Command line: appnmig jeff 


Parsing of the Communications Manager configuration file started. 

Parsing of the Communications Manager configuration file was successful. 

Migration of the Communications Manager configuration started. 

APNO768I1 ‘USIBMMK.CARLEY' has been set as the local control point name. 
This name matches an independent LU definition in the 
Communications Manager configuration, so the control point's alias 
is set to the LU's alias and the control point is defined as an 
independent LU. Applications can use the control point as an 
independent local LU. The control point name will be used to 
identify your workstation to your network management focal point 
(such as NetView). 


APNO784I_ ~=The partner LU with the name 'USIBMMK.LABOQO01' in the 
Communications Manager configuration indicates that it does not 
Support conversation security. All Networking Services/2 partner 
LUS support conversation security. The Communications Manager 
partner LU definition with the alias 'FILESVR' is still added to 
the Networking Services/2 configuration. 


Update of the node definitions file started. 

Update of the node definitions file was successful. 

Update of the security information file started. 

Update of the security information file was successful. 

Verification of the Networking Services/2 configuration started. 
Verification of the Networking Services/2 configuration was successful. 
Update of the Networking Services/2 configuration file started. 

Update of the Networking Services/2 configuration file was successful. 
Berane of the Communications Manager configuration was successful. 


poligurab len Migration Utility ended on 02-07-91 at 01:18p 
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Figure 16. The .LOG File Created by the Migration Utility 


Contents of Your .NDF File after Migration 


The following is the created .NDF file which describes the APPN capabilities of 
your workstation: 
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DEFINE LOCAL CP FQ CP _NAME{USIBMMK.CARLEY ) 
DESCRIPTION({Created by the migration utility on 02-07-91 at 01:17p) 
CP_ALIAS(FILEREQ ) 

NAU ADDRESS(INDEPENDENT_LU) 
NODE_TYPE(EN) 
NODE_ID({X’32222’) 

HOST _FP_SUPPORT(NO); 


DEFINE LOGICAL_LINK LINK NAME(LINKOO001) 
DESCRIPTION(Created by the migration utility on 02-07-91 at 01:17p) 
FQ _ADJACENT_CP_NAME(USIBMMK. CP000002 ) 
ADJACENT NODE_TYPE(LEN) 
DLC NAME(IBMTRNET) 
ADAPTER_NUMBER(0) 
DESTINATION ADDRESS(X’400030010020’) 
CP_CP_SESSION_SUPPORT(NO) 
ACTIVATE _AT_STARTUP(NO) 
LIMITED _ RESOURCE(USE_ADAPTER_DEFINITION) 
LINK_STATION ROLE(USE_ADAPTER_ DEFINITION) 
SOLICIT_SSCP_SESSION(NO) | 
EFFECTIVE CAPACITY({USE_ADAPTER_DEFINITION) 
COST _PER_CONNECT_TIME(USE_ADAPTER_DEFINITION) 
COST _PER_BYTE(USE_ADAPTER. DEFINITION) 
SECURITY(USE ADAPTER_DEFINITION) 
PROPAGATION DELAY(USE_ADAPTER_DEFINITION) 
USER_DEFINED 1(USE_ADAPTER_DEFINITION) 
USER_DEFINED 2(USE_ADAPTER_DEFINITION) 
USER_DEFINED 3(USE_ADAPTER_DEFINITION); 


DEFINE PARTNER_LU FQ PARTNER_LU NAME(USIBMMK.LABO00001 ) 
DESCRIPTION(Created by the migration utility on 02-07-91 at 01:17p) 
PARTNER_LU ALIAS(FILESVR) 

MAX MC _LL SEND _SIZE(32767) 
CONV_ SECURITY _VERIFICATION{NO) 
PARALLEL SESSION SUPPORT(YES); 


DEFINE PARTNER_LU_LOCATION FQ PARTNER_LU NAME(USIBMMK.LABO0001 ) 
DESCRIPTION(Created by the migration utility on 02-07-91 at 01:17p) 
WILDCARD _ENTRY({NO) 
FQ OWNING CP_NAME(USIBMMK.CPO000002 ) 
LOCAL NODE _NN_ SERVER(YES); 


Figure 1/7 (Part 1 of 2). The .NDF File Created by the Migration Utility 
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DEFINE MODE MODE NAME(MODE1  ) 
DESCRIPTION(Created by the migration utility on 02-07-91 at 01:17p) 
COS_NAME(#CONNECT) 
DEFAULT RU_ SIZE(NO) 
MAX_RU_ SIZE UPPER_BOUND(1024) 
RECEIVE PACING WINDOW(8) 
MAX NEGOTIABLE SESSION LIMIT(32767) 
PLU MODE SESSION _LIMIT(10) 
MIN CONWINNERS SOURCE(S): 


DEFINE DEFAULTS IMPLICIT_INBOUND_PLU SUPPORT({NO) 
DESCRIPTION(Created by the migration utility on 02-07-91 at 01:17p) 
DEFAULT MODE _NAME(BLANK) 

DEFAULT LOCAL LU ALIAS(FILEREQ ) 

MAX _MC_LL_SEND_SIZE(32767) 

DIRECTORY FOR_INBOUND_ATTACHES(*) 
DEFAULT_TP_OPERATION(NONQUEUED_AM_STARTED) 
DEFAULT_TP_PROGRAM_TYPE(BACKGROUND) 

DEFAULT TP_CONV_ SECURITY _RQD(NO) 

MAX HELD ALERTS(10); 


DEFINE TP TP _NAME(FILEMSVR) | 
DESCRIPTION(Created by the migration utility on 02-07-91 at 01:17p) 
FILESPEC(C:\SAMPLE\FILECSVR.EXE) 
CONVERSATION_TYPE(EITHER) 
CONV_SECURITY RQD(NO) 
SYNC_LEVEL(EITHER) 
TP_OPERATION(NONQUEUED_ AM_ STARTED) 
PROGRAM_TYPE(BACKGROUND) 
RECEIVE ALLOCATE _TIMEOUT(INFINITE); 


START_ATTACH MANAGER: 


CNOS LOCAL_LU_ ALIAS(FILEREQ ) 

FQ_PARTNER_LU_NAME(USIBMMK.LAB00001 ) 
MODE_NAME(MODE1 ) 
SET_NEGOTIABLE(NO) 
PLU MODE SESSION LIMIT(10) 
MIN. CONWINNERS_ SOURCE(0) 
MIN. CONWINNERS. TARGET(O) 
AUTO_ACTIVATE(0): 


Figure 1/7 (Part 2 of 2). The .NDF File Created by the Migration Utility 


Note: 


e There is no link that supports CP-CP sessions with a network node 
server, so this end node is a LEN node. 

e The link name LINKOOO1 and the CP name CPO00002 were created by 
the migration program. You should change them with more signif- 
icant names such as LOFFICE1 and COFFICE1. Since a CP name can 
be the same as a link name the best may be to name both of them 
OFFICE. 

e The CNOS verb is always built. This verb may be deleted if you 
prefer the CNOS to take place the first time the partners attempt to 
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use that mode. For more information about CNOS see section 8.8, 
“Implicit CNOS” on page 115. 

¢ The IMPLICIT INBOUND PLU SUPPORT is set to NO in the 
DEFINE DEFAULTS parameters which is very restrictive; only the 
defined PLU LABO0001 is allowed to have a conversation with a local 
LU. 


7.2 Node in a Direct Peer Connection with Another Node 


In this section we suppose you want to configure your workstation as an end 
node or network node with a direct peer connection to another node. We call 
direct connection a connection where the machines are physically connected to 
each other. 


Nodes using a direct peer connection don’t use the APPN capability of Net- 
working Services/2 with this connection, but they can have other connections 
that allow them to participate in an APPN network. On this connection they are 
in the same situation as workstations using the APPC capability of Communi- 
cations Manager. 


The location of each partner LU must be defined. You do not have to associate 
local LUs and partner LUs. A local LU may have a session with any defined 
partner LU. 


The following describes how to build an end node that uses direct peer con- 
nections with other nodes (end nodes or network nodes). We will only define 
one direct peer connection. 


In the following section we assume you know how to create a new .NDF file and 
how to use the Presentation Manager panels of Networking Services/2. If you 
don’t, “Creating Your .NDF File” on page 36 explains how to proceed. 


Building the Node with the Presentation Manager Screens 
To configure the network node, follow the these steps: 


1. Go to the Configuration Management window and double-click on 
Configuration File. 


2. If the name of the configuration file NDF you want to work with is not the 
name of the configuration file .NDF that is in the title bar of the Configuration 
Management window, open the configuration file you want to work with by 
selecting Open Configuration File... 


3. Keep or change the Local Node Characteristics, for example: 


e Network ID: USIBMRA 

e Local node name: RALYOS2A 

e Local node ID: 22222 

e Local node alias name: FILEREQ 

e Node type: End Node 

e Activate Attach Manager at start up 

e Comment: Created with the PM interface 
e Click on OK to validate. 


4. Configure the connection to the adjacent node (which is in fact a LEN node): 


e In the Connections window double-click on Peer Node. 
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e In the Adapter List window double-click on the currently configured 
adapter you want to use {we assume you use IBMTRNET adapter 01). 


e Define the link, for example: 


— Link name: LINKLAB 

— Partner network ID: USIBMRA 

— Partner node name: LABOQ0001 

— LAN destination address: 400000022221 
— Comment: Connection peer to the LAB. 


¢ Click on Define Partner LUs... to define all the LUs, including the CP, in 
the end node that you intend to speak with. For example, we define: 


— LU name: LABLU0O1 

— Alias: FILESVR 

— Comment: PLU created while building the link LABLINK 
— Click on Update 

— Click on OK to validate the PLU definition. 


Click on OK to validate the link definition. 
e Close the Connections window. 
5. Go to the advanced SNA window and configure as follows: 


¢ Double-click on Transaction Program Definitions to add a remotely 
Startable TP. We defined: 


— TP name: FILEMSVR 
— Path: C:\SAMPLE\FILECSVR. EXE 
— Comment: FILE SERVER. 


e Double-click on Transaction Program Defaults to define, for example: 


— Default program directory: C:\TP 
— Presentation type: Presentation Manager 
— Operation type: Non-queued, Attach Manager started. 


e Double-click on Transaction Program Security if you want to change a 
TP’s security. 


¢ Double-click on Local LUs if you intend to create a local LU. 
e Double-click on LU-LU Security to define LU-to-LU passwords. 


e Double-click on CPI Communications Side Info to create side information 
for any PLU. 


¢ Double-click on Modes to add a mode definition to the IBM-supplied 
modes, for example: 


— Mode name: MODE1 

— Class of service: #CONNECT 

— Mode session limit: 10 

— Minimum contention winners: 5 

— Receive pacing window: 8 

— RU size: Maximum RU size: 1024 

— Comment: Used by the TPs FILECSVR.EXE and FILECREQ. EXE. 


e Close the Advanced SNA window. 


6. Verify the configuration. 
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The .NDF File 


The following shows the .NDF file that was just built: © 


DEFINE LOCAL CP FQ CP_NAME(USIBMMK.RALYOS2A ) 
DESCRIPTION(Created with the PM interface) 
CP_ALIAS(FILEREQ ) 
NAU_ADDRESS(INDEPENDENT_LU) 
NODE_TYPE(EN) 

NODE_|ID({(X’22222’) 
HOST FP_SUPPORT(NOQO); 


DEFINE LOGICAL LINK LINK _NAME(LINKLAB ) _ 
DESCRIPTION(Connection peer to the LAB) 
FQ ADJACENT _CP_NAME(USIBMRA.LABOOO01 ) 
ADJACENT NODE_TYPE(LEARN) 
DLC_NAME(IBMTRNET) 
ADAPTER_NUMBER(0) 
DESTINATION ADDRESS(X’400000022221’) 
CP_CP_SESSION SUPPORT(NO) 
ACTIVATE_AT_STARTUP(NO) 
LIMITED RESOURCE(USE_ADAPTER_ DEFINITION) 
LINK_STATION ROLE(USE_ADAPTER_DEFINITION) 
SOLICIT SSCP_SESSION(NO) 
EFFECTIVE CAPACITY(USE_ADAPTER_DEFINITION) 
COST_PER_CONNECT_TIME(USE_ADAPTER_DEFINITION) 
COST_PER_BYTE(USE_ADAPTER_DEFINITION) 
SECURITY({USE_ADAPTER_DEFINITION) 
PROPAGATION DELAY(USE_ADAPTER_DEFINITION) 
USER_DEFINED_1(USE_ADAPTER_DEFINITION) 
USER_DErINED 2(USE_ADAPTER_DEFINITION) 
USER_DEFINED 3(USE_ADAPTER_DEFINITION); 


DEFINE PARTNER_LU FQ PARTNER_LU NAME(USIBMRA.LABLUO01 ) 
DESCRIPTION(PLU created while building the link LABLINK) 
PARTNER_LU_ ALIAS(FILESVR) 

MAX MC_LL_SEND_SIZE(32767) 
CONV_SECURITY_VERIFICATION(NO) 
PARALLEL_SESSION SUPPORT(YES); 


DEFINE PARTNER_LU LOCATION FQ PARTNER_LU_NAME(USIBMRA.LABLUOO1 ) 
DESCRIPTION({PLU created while building the link LABLINK) 
WILDCARD_ENTRY({NO) 

FQ OWNING CP_NAME(USIBMRA.LABOO001 ) 
LOCAL_NODE_NN_SERVER(NO); 


Figure 18 (Part 1 of 2). Node in a Direct Peer Connection 
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DEFINE MODE MODE _NAME(MODE1 ) 
DESCRIPTION(Used by the TPs FILECSVR.EXE and FILECREQ.EXE) 
COS_NAME(#CONNECT) 

DEFAULT_RU_SIZE(NO) 
MAX_RU_SIZE UPPER _BOUND(1024) 
RECEIVE PACING WINDOW(8) 
MAX_NEGOTIABLE_SESSION_LIMIT(32767) 
PLU_MODE_SESSION_LIMIT(10) 
MIN_CONWINNERS. SOURCE(S): 


DEFINE DEFAULTS IMPLICIT_INBOUND_ PLU SUPPORT({YES) 
MAX_MC_LL_SEND_SIZE(32767) 
DIRECTORY_FOR_INBOUND_ATTACHES(C:\TP) 

DEFAULT TP_OPERATION(NONQUEUED AM_ STARTED) 
DEFAULT TP_PROGRAM_TYPE(PRESENTATION_ MANAGER) 
DEFAULT _TP_CONV_SECURITY_RQD(NO) 
MAX_HELD_ALERTS(10); 


DEFINE TP TP_NAME(FILEMSVR) 
DESCRIPTION(FILE SERVER) 
FILESPEC(C:\SAMPLE\FILECSVR.EXE) 
CONVERSATION. TYPE(EITHER) 
CONV_SECURITY_RQD(NO) 
SYNC_LEVEL(EITHER) 
TP_OPERATION(NONQUEUED_AM_ STARTED) 
PROGRAM_TYPE/BACKGROUND) 
RECEIVE_ALLOCATE_TIMEOUT(INFINITE): 


START_ATTACH_ MANAGER; 


Figure 18 (Part 2 of 2). Node in a Direct Peer Connection 
Note: 


This end node, which is in fact a LEN node, can have a conversation with 
the following end node obtained by migrating an APPC configured .CFG 
file and adding the definition of the LU LABLUO01 with the Presentation 
Manager interface. 
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DEFINE _LOCAL_CP FQ_CP_NAME(USIBMRA.LABO00001 ) 
DESCRIPTION(Created by the migration utility on 02-07-91 at 03:04p) 
CP_ALIAS(FILEREQ ) 

NAU_ADDRESS{INDEPENDENT_LU) 
NODE_TYPE(EN) 
NODE_ID(X’22221’) 

HOST _FP_SUPPORT({NO); 


DEFINE_LOGICAL_LINK LINK _NAME({LINKO001) 
DESCRIPTION(Created by the migration utility on 02-07-91 at 03:04p) 
FQ ADJACENT CP_NAME(USIBMRA.CPO00002 ) 
ADJACENT NODE_TYPE(LEN) 
DLC_NAME(IBMTRNET) 
ADAPTER_NUMBER(0) 
DESTINATION. ADDRESS(X’400000022222’) 
CP_CP_SESSION SUPPORT(NO) 
ACTIVATE_AT_STARTUP(NO) 
LIMITED RESOURCE(USE_ADAPTER_DEFINITION) 
LINK_STATION ROLE(USE_ADAPTER_DEFINITION) 
SOLICIT_SSCP_SESSION(NO) 
EFFECTIVE CAPACITY(USE_ADAPTER_DEFINITION) 
COST_PER_CONNECT_TIME(USE_ADAPTER_DEFINITION) | 
COST_PER_BYTE(USE_ADAPTER_DEFINITION) 
SECURITY(USE_ADAPTER_DEFINITION) 
PROPAGATION DELAY(USE_ADAPTER_DEFINITION) 
USER_DEFINED 1(USE_ADAPTER_DEFINITION) 
USER_DEFINED_2(USE_ADAPTER_DEFINITION) 
USER_DEFINED_3(USE_ADAPTER_DEFINITION); 


DEFINE _LOCAL_LU LU_NAME(LABLUOO‘) 
LU_ALIAS(LABLUO01) 
NAU_ADDRESS(INDEPENDENT_LU); 


DEFINE PARTNER_LU FQ PARTNER_LU NAME(USIBMRA.RALYOS2A ) 
DESCRIPTION(Created by the migration utility on 02-07-91 at 03:04p) 
PARTNER_LU ALIAS(FILESVR) 

MAX _MC_LL_SEND_SIZE(32767) 
CONV_SECURITY_VERIFICATION(NO) 
PARALLEL_SESSION SUPPORT(YES); 


Figure 19 (Part 1 of 2). Node That May Support a Peer Connection with the Previously Created End Node 
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DEFINE PARTNER_LU LOCATION FQ PARTNER_LU_NAME(USIBMRA.RALYOS2A ) 
DESCRIPTION(Created by the migration utility on 02-07-91 at 03:04p) 
WILDCARD _ENTRY(NO) 
FQ OWNING CP NAME(USIBMRA.CPO00002 ) 
LOCAL NODE _NN_SERVER(YES); 


DEFINE MODE MODE NAME(MODE1  ) 
DESCRIPTION(Created by the migration utility on 02-07-91 at 03:04p) 
COS_NAME(#CONNECT) 
DEFAULT RU_SIZE(NO) 
MAX _RU_ SIZE UPPER _BOUND(1024) 
RECEIVE PACING WINDOW(8) 
MAX NEGOTIABLE SESSION _LIMIT(32767) 
PLU MODE SESSION _LIMIT(10) 
MIN _CONWINNERS_ SOURCE(S); 


DEFINE DEFAULTS IMPLICIT INBOUND PLU SUPPORT(NO) 
DESCRIPTION(Created by the migration utility on 02-07-91 at 03:04p) 
DEFAULT MODE NAME(BLANK) 

DEFAULT LOCAL LU ALIAS(FILEREQ ) 

MAX MC_LL_SEND_SIZE(32767) 
DIRECTORY_FOR_INBOUND_ATTACHES(’*) 

DEFAULT TP_OPERATION(NONQUEUVED AM_ STARTED) 
DEFAULT TP_PROGRAM_TYPE(BACKGROUND) 

DEFAULT _TP_CONV_ SECURITY _RQD(NO) 

MAX HELD ALERTS(10): 


DEFINE TP TP_NAME(FILEMSVR) 
DESCRIPTION(Created by the migration utility on 02-07-91 at 03:04p) 
FILESPEC(C:\SAMPLE\FILECSVR.EXE) 
CONVERSATION_TYPE(EITHER) 
CONV_SECURITY_RQD(NO) 
SYNC_LEVEL(EITHER) 
TP_OPERATION{(NONQUEUED_AM_ STARTED) 
PROGRAM_TYPE(BACKGROUND) 
RECEIVE ALLOCATE _TIMEOUT(INFINITE); 


START_ATTACH MANAGER; 


CNOS LOCAL LU ALIAS(FILEREQ ) 
FQ PARTNER _LU_NAME(USIBMRA.RALYOS2A ) 
MODE _NAME(MODE1 ) 

SET_NEGOTIABLE(NO) 
PLU_MODE_SESSION_LIMIT(10) 
MIN. CONWINNERS. SOURCE(0) 
MIN. CONWINNERS_TARGET(0) 
AUTO_ACTIVATE(0): 


Figure 19 (Part 2 of 2). Node That May Support a Peer Connection with the Previously Created End Node 
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7.3 Network Node 


A network node can have two kinds of connections with another node: 


e With CP-CP session support 
e Without CP-CP session support. 


An end node can have a pair of active CP-CP sessions with its serving network 
node. This allows the network node to learn what LUs are on the end node. So, 
when a search for an LU on this end node arrives on the network node, the 
network node gives a positive response. 


When an LU of an end node intends to speak to another LU of the network, the 
LU contacts the network node that it has CP-CP sessions with. This network 
node is the entry-point in the APPN network for the end node. It is called the 
preferred server of the end node. The end nodes served by a network node are 
said to be in the domain of the network node. 


An end node may have many links that support CP-CP sessions with network 
nodes but it may only have one active CP-CP session at a time. That means an 
end node may only belong to one domain. 


You should always give to each end node the capability to have CP-CP sessions 
with a network node and define this network node as the preferred server of the 
end node. These definitions are made in the end node. It is the easiest way to 
make the end node participate in the APPN network. 


The link that supports a CP-CP session must always stay active. If you don’t 
have such a link, for example, if your end node is attached to a network node 
through a switched link, there is still a way to define the end node and the 
network node where the network node will provide servers to the end node. In 
that case, the end node will in fact be a LEN node. 


We will now see how to define: 


e A network node connected to an end node in its domain 

¢ A network node connected to an end node out of its domain 
e A network node acting as a server for a LEN node 

e A network node backup server of an end node 

e A network node connected to another network node. 


7.4 Network Node Server of an End Node in Its Domain 
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If you are using a token-ring LAN, also see section 7.15, “Connection Network” 
on page 8/7. 


In the following section we assume you know how to create a new .NDF file and 
how to use the Presentation Manager panels of Networking Services/2. If you 
don’t, “Creating Your .NDF File” on page 36 explains how to proceed. 


We will first see how to configure the network node and then an end node in its 
domain. This can be done either with the Create/Quick Configuration window or 
with the Configuration Management window. 
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7.5 Network Node Server of the Domain 


To configure the network node server of the domain, follow the next steps: 


1. Go to the Configuration Management window and double-click on 
Configuration File. 


2. If the name of the configuration file NDF you want to work with is not the 
name of the configuration file .NDF that is in the title bar of the Configuration 
Management window, open the configuration file you want to work with by 
selecting Open Configuration File... 


3. Keep or change the Local Node Characteristics, for example: 


Network ID: USIBMRA 

Local node name: RALY0S2A 

Local node ID: 22222 

Local node alias name: RALY0S2A (keep the node name) 
Node type: Network Node 

Activate Attach Manager at start up 

Comment: Created with the PM interface 

Click on OK to validate. 


4. Configure the connection to the end node: 


In the Connections window double-click on End Node (or Unknown Node 
Type). 


In the Adapter List window double-click on the currently configured 
adapter you want to use (we assume you use IBMTRNET adapter 00). 


Define the link, for example: 


— Link name: EN1 
— LAN destination address: 400000022221 
— Comment: Link to an EN of the Domain. 


Close the Connections window. 


5. Define the advanced SNA capabilities of the node (LU, TP, Mode, etc...). You 
should at least define the defaults. 


6. Verify the configuration. 


The .NDF File 
Here is the .NDF that has been created: 
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DEFINE LOCAL CP FQ CP_NAME(USIBMRA.RALYOS2A ) 
DESCRIPTION(Created with the PM interface) 
CP_ALIAS(RALYOS2A) 

NAU ADDRESS(INDEPENDENT_ LU) 
NODE_TYPE(NN) 
NODE_ID{(X’22222’) 

HOST FP_SUPPORT(NO); 


DEFINE LOGICAL_LINK LINK _NAME(EN1 _ ) 
DESCRIPTION(Link to an EN of the Domain) 
ADJACENT NODE_TYPE(LEARN) 
DLC_NAME(IBMTRNET) 
ADAPTER_NUMBER(O) 
DESTINATION ADDRESS(X’400000022221’) 
CP_CP_ SESSION SUPPORT(YES) 
ACTIVATE _AT STARTUP(YES) 
LIMITED RESOURCE(USE_ ADAPTER_DEFINITION) 
LINK_STATION ROLE(USE ADAPTER_DEFINITION) 
SOLICIT SSCP_SESSION(NO) 
EFFECTIVE CAPACITY(USE_ ADAPTER_DEFINITION) 
COST_PER_CONNECT_TIME(USE_ADAPTER_DEFINITION) 
COST_PER_BYTE(USE_ADAPTER_DEFINITION) 
SECURITY(USE_ADAPTER_DEFINITION) 
PROPAGATION DELAY(USE_ADAPTER_DEFINITION) 
USER_DEFINED_1(USE_ADAPTER_DEFINITION) 
USER_DEFINED_2(USE_ADAPTER_DEFINITION) 
USER_DEFINED_ 3(USE_ADAPTER_DEFINITION); 


START_ATTACH_MANAGER; 


Figure 20. Network Node Server of a Domain 


Note: 


You do not have to define in the network node server, the modes you 
define in the end nodes that the network node serves. A mode only 
needs to be defined in the nodes that contain the TPs using it. 


7.6 End Node in the Domain of a Network Node Server penne? with the 


Create/Quick Configuration Window 
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When you use the Create/Quick window you do not need to have an .NDF file to 
modify. The .CFG alone is sufficient. 


Using the Create/Quick window, you have to type very little information, for 
example: 


1. If you have two adapters configured you have to click on the one you intend 
to use (we Suppose you select adapter 00) 


2. Type the requested information: 


e Network ID: USIBMRA 
e Local node name: ENCN 
e Network node server address: 400000022222 
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3. If you have made a mistake and want to use the other adapter select Cancel; 
otherwise, select Verify. 


4. You may then select Additional Configuration to go to the Configuration 
Management window (see section 7.7, “End Node in the Domain of a 
Network Node Server Defined with the Configuration Management Window” 
on page 75) or Cancel (twice if you have two configured adapters) to exit. 


If you have two configured adapters, here is what you must NOT do: 


1. Select one adapter, type information, select Verify and select Cancel 
2. Select the other adapter, type information, select Verify and select Cancel 
twice to exit. 


This would give two preferred network node servers to your workstation. During 
the second verification a warning would tell you to look at the .LOG file where 
this error would be written. 


Here is the .NDF we have just built. You will notice that many definitions were 
automatically added to the information you gave; for example, the 
DEFINE DEFAULTS and START ATTACH MANAGER verbs. 


Moreover, there are definitions for the connection network for each configured 
adapter (even the one you did not select!). This is discussed in section 7.15, 
“Connection Network” on page 87. 


The .NDF File 
Here is the .NDF that has been created: 
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DEFINE LOCAL_CP FQ _CP_NAME(USIBMRA.ENCN _ ) 
CP_ALIAS(ENCN _ ) 
NAU_ADDRESS(INDEPENDENT._LU) 
NODE_TYPE(EN) 

NODE_1ID(x’00000’) 
HOST _FP_SUPPORT(NO): 


DEFINE_CONNECTION NETWORK FQ_CN_NAME(USIBMRA.PU000000 ) 
ADAPTER_INFO( DLC_NAME(IBMTRNET) 
ADAPTER_NUMBER(0)): 


DEFINE_CONNECTION NETWORK FQ_CN_NAME(USIBMRA.BB119 _ ) 
ADAPTER_INFO( DLC_NAME(IBMTRNET) 
ADAPTER_NUMBER(1)); 


DEFINE LOGICAL_LINK LINK _NAME(LINK0001) 
ADJACENT _NODE_TYPE(NN) 
PREFERRED_NN_SERVER(YES) 
DLC_NAME(IBMTRNET) 
ADAPTER_NUMBER(0) 
DESTINATION ADDRESS(X’400000022222’) 
CP_CP_SESSION SUPPORT(YES) | 
ACTIVATE_AT_STARTUP(YES) 
LIMITED. RESOURCE(USE_ADAPTER_DEFINITION) 
LINK_STATION ROLE(USE_ADAPTER_DEFINITION) 
SOLICIT SSCP_SESSION(NO) 
EFFECTIVE _CAPACITY(USE_ADAPTER_ DEFINITION) 
COST _PER CONNECT TIME(USE_ADAPTER_DEFINITION) 
COST PER BYTE(USE_ ADAPTER DEFINITION) 
SECURITY(USE_ADAPTER_DEFINITION) 
PROPAGATION DELAY(USE_ADAPTER_DEFINITION) 
USER_DEFINED_1(USE_ADAPTER_DEFINITION) 
USER_DEFINED 2(USE_ ADAPTER DEFINITION) 
USER_DEFINED 3(USE_ADAPTER DEFINITION): 


DEFINE DEFAULTS IMPLICIT INBOUND _PLU_SUPPORT(YES) 
DEFAULT MODE_NAME(BLANK) 
MAX _MC_LL_SEND_ SIZE(32767) 
DIRECTORY_FOR_INBOUND ATTACHES(’) 
DEFAULT TP_OPERATION(NONQUEUED AM STARTED) 
DEFAULT _TP_ PROGRAM TYPE(BACKGROUND) 
DEFAULT _TP_CONV_SECURITY_RQD(NO) 
MAX_HELD_ALERTS(10); 


START_ATTACH_ MANAGER; 


Figure 21. End Node in a Domain Created with the Create/Quick Configuration Window 
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7.7 End Node in the Domain of a Network Node Server Defined with the 
Configuration Management Window 


If you intend to use the Configuration Management window directly, follow these 
steps: 


1. Go to the Configuration Management window and double-click on 
Configuration File. 


2. If the name of the configuration file NDF you want to work with is not the 
name of the configuration file .NDF that is in the title bar of the Configuration 
Management window, open the configuration file you want to work with by 
selecting Open Configuration File... 


3. Keep or change the Local Node Characteristics, for example: 


e Network ID: USIBMRA 

e Local node name: EN1 

e Local node ID: 22221 

e Local node alias name: EN1 (keep the node name) 
e Node type: End Node 

e Activate Attach Manager at start up 

« Comment: Created with the PM interface 

e Click on OK to validate. 


4. Configure the connection to the network node: 
e In the Connections window double-click on Network Node. 


e In the Adapter List window double-click on the currently configured 
adapter you want to use (we assume you use IBMTRNET adapter 00). 


¢ Define the link, for example: 


— Link name: NNSERVER 

— LAN destination address: 400000022222 

— Select Use this network node connection as your preferred server 
— Comment: Link to the Network Node Server of the Domain. 


e Close the Connections window. 


5. Define the advanced SNA capabilities of the node (LU, TP, Mode, etc...). You 
should at least define the defaults. 


6. Verify the configuration. 


The .NDF File 


Here is the .NDF that has been created: 
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DEFINE LOCAL CP FQ _CP_NAME(USIBMRA.EN1 _ ) 
DESCRIPTION(Created with the PM interface) 
CP_ALIAS(EN1 ) 
NAU_ADDRESS(INDEPENDENT_LU) 
NODE_TYPE(EN) 

NODE_1D(X’22222’) 
HOST _FP_SUPPORT(NO): 


DEFINE_LOGICAL_LINK LINK_NAME(NNSERVER) 
DESCRIPTION(Link to the Network Node Server of the Domain) 
ADJACENT _NODE_TYPE(NN) 
PREFERRED_NN_SERVER(YES) 
DLC_NAME(IBMTRNET) 
ADAPTER_NUMBER(0) 
DESTINATION_ADDRESS(X’400000022222’) 
CP_CP_SESSION_SUPPORT(YES) 
ACTIVATE_AT_STARTUP(YES) 
LIMITED_RESOURCE(USE_ADAPTER_DEFINITION) 
LINK_STATION_ROLE(USE_ADAPTER_DEFINITION) 
SOLICIT_SSCP_SESSION(NO) 
EFFECTIVE_CAPACITY(USE_ADAPTER_DEFINITION) 
COST_PER_CONNECT_TIME(USE_ADAPTER_DEFINITION) 
COST_PER_BYTE(USE_ADAPTER_DEFINITION) 
SECURITY(USE_ADAPTER_DEFINITION) 
PROPAGATION _DELAY(USE_ADAPTER_DEFINITION) 
USER_DEFINED_1(USE_ADAPTER_DEFINITION) 
USER_DEFINED_2(USE_ADAPTER_DEFINITION) 
USER_DEFINED_3(USE_ADAPTER_DEFINITION); 


START_ATTACH_MANAGER; 


Figure 22. End Node in a Domain Created with the Configuration Management Window 


7.8 Network Node and Non-Domain End Node 
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In the following section we assume you know how to create a new .NDF file and 
how to use the Presentation Manager panels of Networking Services/2. If you 
don’t, “Creating Your .NDF File” on page 36 explains how to proceed. 


The definition of the network node is the same as in section 7.14, “Network Node 
Connected to Another Network Node” on page 86. 


To configure an end node out of the domain of a network node, follow the next 
steps: 


1. Go to the Configuration Management window and double-click on 
Configuration File 


2. If the name of the configuration file NDF you want to work with is not the 
name of the configuration file .NDF that is in the title bar of the Configuration 
Management window, open the configuration file you want to work with by 
selecting Open Configuration File... 


3. Keep or change the Local Node Characteristics, for example: 
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¢ Network ID: USIBMRA 

e Local node name: EN2 

e Local node ID: 22223 

e Local node alias name: EN2 (keep the node name) 
e Node type: End Node 

e Activate Attach Manager at start up 

e Comment: Created with the PM interface 

e Click on OK to validate. 


4. Configure the connection to the network node: 
e In the Connections window double-click on Network Node. 


e Inthe Adapter List window double-click on the currently configured 
adapter you want to use (we assume you use IBMTRNET adapter 00). 


e Define the link, for example: 


— Link name: NN 

— LAN destination address: 400000022222 

— Do not select Use this network node connection as your preferred 
server 

— Comment: Link to a Network Node out of the Domain. 


« Close the Connections window. 


5. Define the advanced SNA capabilities of the node (LU, TP, Mode, etc...). You 
should at least define the defaults. 


6. Verify the configuration. 


The .NDF File 


Here is the .NDF that has been created: 
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DEFINE LOCAL_CP FQ _CP_NAME(USIBMRA.EN2  ) 


DESCRIPTION(Created with the PM interface) 
CP ALIAS(EN2  ) 
NAU_ADDRESS(INDEPENDENT_LU) 
NODE_TYPE(EN) 

NODE_ID(X’22223’) 

HOST _FP_SUPPORT(NO); 


DEFINE LOGICAL_LINK LINK _NAME(NN _ ) 


DESCRIPTION(Link to a Network Node out of the Domain) 
ADJACENT NODE_TYPE{NN) 
PREFERRED NN SERVER(NO) 

DLC_NAME(IBMTRNET) 


- ADAPTER_NUMBER(O) 


DESTINATION ADDRESS(X’400000022222’) 
CP_CP_SESSION_SUPPORT(YES) 
ACTIVATE_AT_STARTUP(YES) 

LIMITED. RESOURCE(USE_ADAPTER_DEFINITION) 
LINK_STATION ROLE(USE_ADAPTER_DEFINITION) 
SOLICIT_SSCP_SESSION(NO) 

EFFECTIVE _CAPACITY(USE_ADAPTER_ DEFINITION) 
COST PER CONNECT TIME(USE_ADAPTER_DEFINITION) 
COST PER BYTE(USE_ADAPTER DEFINITION) 
SECURITY(USE_ADAPTER_DEFINITION) 
PROPAGATION DELAY(USE_ADAPTER_DEFINITION) 
USER_DEFINED 1(USE_ADAPTER_DEFINITION) 
USER DEFINED 2(USE_ADAPTER DEFINITION) 
USER DEFINED 3(USE_ADAPTER_ DEFINITION): 


START_ATTACH_MANAGER; 


Figure 23. End Node Out of a Domain 


7.9 Network Node Acting as a Server for an End Node without CP-CP Session 


(LEN Node) 


In the following section we assume you know how to create a new .NDF file and 
how to use the Presentation Manager panels of Networking Services/2. If you 
don’t, “Creating Your .NDF File” on page 36 explains how to proceed. 


We will see first how to configure the network node and then an end node 
attached to it as a LEN node. We will illustrate this configuration with a sample 
APPN network. | 


7.10 Network Node Acting as a Server for a LEN Node 


To configure the network node with an end node attached to it as a LEN node, 
follow these steps: 


1. Go to the Configuration Management window and double-click on 
Configuration File. 
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2. If the name of the configuration file NDF you want to work with is not the 
name of the configuration file .NDF that is in the title bar of the Configuration 
Management window, open the configuration file you want to work with by 
selecting Open Configuration File... 


3. Keep or change the Local Node Characteristics, for example: 


* Network ID: USIBMRA 

e Local node name: NN1 

e Local node ID: 22221 

e Local node alias name: NN1 (keep the node name) 
e Node type: Network Node 

e Activate Attach Manager at start up 

¢ Comment: Created with the PM interface 

e Click on OK to validate. 


4. Configure the connection to the end node (which is in fact a LEN node): 
« In the Connections window double-click on LEN Node. 


e |n the Adapter List window double-click on the currently configured 
adapter you want to use (we assume you use IBMTRNET adapter 01). 


e Define the link, for example: 


— Link name: EN1 

— Partner network ID: USIBMRA 

— Partner node name: EN1 

— LAN destination address: 400032BB119B 

— Comment: Link to an EN defined as a LEN Node. 


° Click on Define Partner LUs... to define all the LUs in the end node, 
including the CP. For example, we define: 


— The CP of the end node 
- LU name: EN1 
- Alias: EN1 
- Comment: Definition of the EN's CP 
- Click on Update. 
— An LU in the end node 
- LU name: LU1 
- Alias: LUI 
- Comment: Other LU in the EN defined as a LEN Node 
- Click on Update. 
— Click on OK to validate the PLU definitions. 


Click on OK to validate the link definition. 
¢ Close the Connections window. 
9. Define the advanced SNA capabilities of the node (LU, TP, Mode, etc...). 
6. Verify the configuration. 


The .NDF File 
Here is the .NDF that has been created: 
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DEFINE LOCAL CP FQ _CP_NAME(USIBMRA.NN1 ) 
DESCRIPTION{(Created with the PM interface) 
CP_ALIAS(NN1 ) 

NAU_ ADDRESS(INDEPENDENT_LU) 
NODE_TYPE(NN) 
NODE_ID{(X’22221’) 

HOST _FP_SUPPORT(NO); 


DEFINE LOGICAL_LINK LINK NAME(EN1 _ ) 
DESCRIPTION(Link to an EN defined as a LEN Node) 
FQ ADJACENT CP_NAME(USIBMRA.EN1 _ ) 
ADJACENT _NODE_TYPE(LEN) 
DLC_NAME(IBMTRNET) 
ADAPTER_NUMBER(1) 
DESTINATION _ADDRESS(X’400032BB119B’) 
CP_CP SESSION SUPPORT(NO) 
ACTIVATE_AT_STARTUP(YES) 
LIMITED. RESOURCE(USE_ADAPTER_DEFINITION) 
LINK_STATION ROLE(USE_ADAPTER_DEFINITION) 
SOLICIT SSCP_SESSION(NO) 
EFFECTIVE CAPACITY(USE_ADAPTER_DEFINITION) 
COST PER CONNECT TIME(USE_ADAPTER_DEFINITION) 
COST PER BYTE(USE_ADAPTER_DEFINITION) 
SECURITY(USE_ADAPTER_DEFINITION) 
PROPAGATION DELAY(USE_ADAPTER_DEFINITION) 
USER_DEFINED 1(USE_ADAPTER DEFINITION) 
USER DEFINED 2(USE_ADAPTER_DEFINITION) 
USER_DEFINED 3(USE_ADAPTER DEFINITION): 


DEFINE PARTNER_LU FQ PARTNER_LU_ NAME(USIBMRA.EN1 ) 
DESCRIPTION(Definition of the EN’s CP) 
PARTNER_LU_ ALIAS(EN‘1) 

MAX MC_LL_ SEND_SIZE(32767) 
CONV_SECURITY VERIFICATION(NO) 
PARALLEL SESSION SUPPORT(YES); 


DEFINE PARTNER_LU FQ PARTNER_LU_NAME(USIBMRA.LU1 _ ) 
DESCRIPTION(Other LU in the EN defined as a LEN Node) 
PARTNER_LU_ALIAS(LU‘) 

MAX _MC_LL_SEND_ SIZE(32767) 
CONV_SECURITY_VERIFICATION(NO) 
PARALLEL_SESSION_SUPPORT(YES); 


DEFINE PARTNER_LU LOCATION FQ _PARTNER_LU NAME(USIBMRA.EN1 
DESCRIPTION(Definition of the EN’s CP) 
WILDCARD_ENTRY(NO) 

FQ OWNING _CP_NAME(USIBMRA.EN1 _ ) 
LOCAL_NODE_NN_SERVER(YES): 


Figure 24 (Part 1 of 2). Network Node Defined as the Server of a LEN Node 
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DEFINE PARTNER_LU LOCATION FQ PARTNER_LU NAME(USIBMRA.LU1 
DESCRIPTION({Other LU in the EN defined as a LEN Node) 
WILDCARD_ENTRY(NO) 

FQ OWNING CP_NAME(USIBMRA.EN1 ) 
LOCAL NODE NN_SERVER(YES); 


‘START_ATTACH MANAGER: 


Figure 24 (Part 2 of 2). Network Node Defined as the Server of a LEN Node 


7.11 End Node Attached to a Network Node as a LEN Node 


To configure the end node attached to the network node as a LEN node, follow 
these steps: 


1. Go to the Configuration Management window and double-click on 
Configuration File. 


2. If the name of the configuration file NDF you want to work with is not the 
name of the configuration file .NDF that is in the title bar of the Configuration 
Management window, open the configuration file you want to work with by 
selecting Open Configuration File... 


3. Keep or change the Local Node Characteristics, for example: 


¢ Network ID: USIBMRA 

e Local node name: EN1 

e Local node ID: 00001 

e Local node alias name: EN1 (keep the node name) 
e Node type: Network Node 

e Activate Attach Manager at start up 

e Comment: EN attached to a NN as a LEN Node 

e Click on OK to validate. 


4. Configure the connection to the network node: 
e In the Connections window double-click on Peer Node. 


e In the Adapter List window double-click on the currently configured 
adapter you want to use (we assume you use IBMTRNET adapter 00). 


¢ Define the link, for example: 


— Link name: NN1 

— Partner network ID: USIBMRA 

— Partner node name: NN1 

— LAN destination address: 400032BB119A 

— Comment: Connection to a NN that will serve this Node. 


Click on OK to validate the link definition. 
e Close the Connections window. 
5. Go to the Advanced SNA window and configure as follow: 
e Double-click on Transaction Program Defaults to define, for example: 


— Default program directory: * 
— Presentation type: Background 
— Operation type: Non-queued, Attach Manager started. 
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Double-click on Local LUs to define, for example: 
— LU name: LU1 

— Alias: LU1 

— NAU address: Independent 

— Comment: Created with the PM interface. 


¢ Close the Advanced SNA window. 
6. Verify the configuration. 
7. Edit the .NDF file: 


e In the DEFINE LOGICAL LINK verb: 
— If you keep the ACTIVATE_AT_ STARTUP to NO, you will have to acti- 
vate the link from an application or manually by selecting APPN -> 
Subsystem Management from the Configuration Management window. 


e Add the following verb, which allows any local LU to speak to any LU in 
the APPN network of the network node: 


DEFINE _PARTNER_LU_LOCATION WILDCARD_ENTRY(FULL) 
FQ OWNING CP_NAME(USIBMRA.NN1 ) 


LOCAL NODE _NN_SERVER(NO); 
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The .NDF File 
Here is the .NDF that has been created: 
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DEFINE LOCAL CP FQ CP _NAME(USIBMRA.EN1 ) 
DESCRIPTION{EN attached to a NN as a LEN Node) 
CP_ALIAS(EN1  ) 

NAU ADDRESS(INDEPENDENT_ LU) 
NODE_TYPE(EN) 
NODE_1D(X’00001’) 

HOST FP_SUPPORT(NO); 


DEFINE LOGICAL LINK LINK _NAME(NN1 _ ) 
DESCRIPTION(Connection to a NN that will serve this Node) 
FQ ADJACENT _CP_NAME(USIBMRA.NN‘1 ) 
ADJACENT NODE_TYPE(LEARN) 

DLC_NAME{IBMTRNET) 

ADAPTER_NUMBER(0) 

DESTINATION. ADDRESS(X’400032BB119A’) 
CP_CP_SESSION SUPPORT(NO) 
ACTIVATE_AT_STARTUP(YES) 

LIMITED RESOURCE(USE_ ADAPTER_DEFINITION) 
LINK_STATION ROLE(USE_ADAPTER_DEFINITION) 
SOLICIT SSCP_SESSION(NO) 
EFFECTIVE CAPACITY(USE ADAPTER_DEFINITION) 
COST _PER_CONNECT TIME(USE ADAPTER_DEFINITION) 
COST PER_BYTE(USE_ADAPTER_DEFINITION) 
SECURITY(USE_ADAPTER_DEFINITION) 
PROPAGATION DELAY(USE ADAPTER_DEFINITION) 
USER_DEFINED_1(USE_ADAPTER_DEFINITION) 
USER DEFINED 2(USE_ADAPTER_DEFINITION) 
USER_DEFINED 3(USE_ADAPTER_DEFINITION); 


DEFINE LOCAL LU LU NAME(LU1  ) 
DESCRIPTION({Created with the PM interface) 
LU ALIAS({(LU‘ ) 
NAU ADDRESS(INDEPENDENT_ LU); 


DEFINE PARTNER_LU_ LOCATION WILDCARD ENTRY(FULL) 
FQ OWNING CP_NAME(USIBMRA.NN1 _) 
LOCAL_NODE_NN_SERVER(NO): 


DEFINE DEFAULTS IMPLICIT INBOUND PLU SUPPORT{YES) 
DESCRIPTION(Created under PM) 
MAX _MC_LL_SEND_SIZE(32767) 
DIRECTORY _FOR_INBOUND_ ATTACHES(*) 
DEFAULT _TP_OPERATION(NONQUEUED_ AM_ STARTED) 
DEFAULT _TP_PROGRAM_TYPE(BACKGROUND) 
DEFAULT _TP_CONV_ SECURITY _RQD(NO) 
MAX _ HELD ALERTS(10); 


START ATTACH MANAGER; 


Figure 25. End Node Served by a Network Node without CP-CP Session 
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7.12 Sample APPN Network with an End Node Attached to a Network Node as 


a LEN Node 
EN1-—( )—INN1 NN2 EN2 
Lui! NO CP-cCP CP-CP cp-cPp | Lu2 


Figure 26. Sample APPN Network with a LEN Node Served by a Network Node 


In this APPN network, the nodes EN1 and NN1 are configured as explained 
above. Any LU of the network can have a session with any other LU. 


There is no definition for LU1 in NN2 or EN2. The only definitions for LU1 are in 
NN1 and EN1. 


For an LU in EN1, all the LUs of the APPN network are seen as being located in 
NN1. NN1 is the server for LUs in EN1 and LUs in the APPN network can find 
them though the APPN directory function. 


7.13 Network Node Backup Server of an End Node 


Networking Services/2 has not implemented a backup network node server func- 
tion. You may define a network node to act like a backup server, but there are 
some inconveniences. 


The backup network node server is nothing more than a network node to which 
the end node is attached as a LEN node. 


End Node Definition 


To define the end node follow these steps: 


1. Define the end node and its connection to its network node server (see 
section 7.7, “End Node in the Domain of a Network Node Server Defined with 
the Configuration Management Window” on page 75) 


2. Define the connection to the backup network node server (see section 7.11, 
“End Node Attached to a Network Node as a LEN Node” on page 81). 


Network Node Definition 


To define the network node backup see section 7.10, “Network Node Acting as a 
Server for a LEN Node” on page 78. You must define in the backup all the LUs 
that are in the end node. 


Comments 


The following figure shows the difference between the definitions of the server 
and of its backup: 
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Network Node Server and Network Node Backup of an End Node 


NNServer 


LINK | 
cp cp session support(yes) 
adjacent_node_type(learn) 


LINK 
adjacent_node_type(nn) 
preferred nn_server(yes) 
cp_cp_ session support (yes) 


LINK 
fq_adjacent_cp_name(NET.NNB) 
adjacent_node_type(learn) 
preferred _nn_server(yes) 
cp_cp session support(no) 


DEFINE PLU LOCATION 
wildcard _entry(full) 


fq_owning_cp_name(NET.NNB) a | 
URED NNBackup 
LINK 


cp_cp session support (no) 
adjacent_node_type(len) 
fq_adjacent_cp_name(NET.EN) 


DEFINE PLU LOCATION -> for each lu in EN 
fq_partner_lu_name(NET.1u) 
wildcard(no) 


— fq_owning cp_name(NET.EN) 
local_node_nn_server(yes) 


Figure 27. Differences in the Definitions of a Network Node Server and a Network Node Backup 


The definitions at EN allow it to issue outbound allocates even if its network node 
server NNS goes down. The definitions at NNB allow allocates to reach the EN if 
NNS is down. However, if the network is completely up, both network nodes will 
answer network searches for EN, and you might not get the optimal route. 


What we mean is that NNB will answer for EN as a LEN node, and the calculated 
route will always be through NNB, while NNS would consider all the possible 
network routes and calculate the best one. NNB will also usually be the first to 
respond to a network search, because NNS will send a message to its served EN 
to verify it is still there; so, you'll likely see the route go through NNB. 
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7.14 Network Node Connected to Another Network Node 


In the following section we assume you know how to create a new NDF file and 
how to use the Presentation Manager panels of Networking Services/2. If you 
don’t, “Creating Your .NDF File” on page 36 explains how to proceed. 


To configure a network node with a connection to another network node follow 
these steps: 


1. Go to the Configuration Management window and double-click on 
Configuration File. 


2. If the name of the configuration file .NDF you want to work with is not the 
name of the configuration file NDF that is in the title bar of the Configuration 
Management window, open the configuration file you want to work with by 
selecting Open Configuration File... 


3. Keep or change the Local Node Characteristics, for example: 


Network ID: USIBMRA 

Local node name: NN1 

Local node ID: 22221 

Local node alias name: NN1 (keep the node name) 
Node type: Network Node 

Activate Attach Manager at start up 

Comment: Created with the PM interface 

Click on OK to validate. 


4. Configure the connection to the network node: 


In the Connections window double-click on Network Node. 


In the Adapter List window double-click on the currently configured 
adapter you want to use (we assume you use IBMTRNET adapter O00). 


Define the link, for example: 


— Link name: NN2 
— LAN destination address: 400000022222 
— Comment: Link to another NN. 


Close the Connections window. 


5. Define the advanced SNA capabilities of the node (LU, TP, Mode, etc...). 


6. Verify the configuration. 


The .NDF File 


Here is the .NDF that has been created: 
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DEFINE LOCAL CP FQ CP _NAME(USIBMRA.NN1 ) 
DESCRIPTION(Created with the PM interface) 
CP_ALIAS(NN1 _ ) 

NAU ADDRESS(INDEPENDENT_ LU) 
NODE_TYPE(NN) 
NODE_ID(X’22221’) 

HOST FP_SUPPORT(NO); 


DEFINE LOGICAL_LINK LINK_NAME(NN2 _ ) 
ADJACENT NODE_TYPE(NN) 
PREFERRED _NN_SERVER(NO) 
DLC_NAME(IBMTRNET) 
ADAPTER_NUMBER(0) 
DESTINATION ADDRESS(X’400000022222’) 
CP_CP SESSION SUPPORT(YES) 
ACTIVATE_AT_STARTUP(YES) 
LIMITED. RESOURCE(NO) 
LINK STATION ROLE(USE_ADAPTER_DEFINITION) 
SOLICIT_SSCP_SESSION(NO) 
EFFECTIVE CAPACITY(USE_ADAPTER_DEFINITION) 
COST PER CONNECT TIME(USE_ADAPTER_ DEFINITION) 
COST PER BYTE(USE_ADAPTER_DEFINITION) 
SECURITY(USE_ADAPTER_DEFINITION) 
PROPAGATION DELAY(USE_ADAPTER_DEFINITION) 
USER_DEFINED 1(USE_ADAPTER DEFINITION) 
USER DEFINED 2(USE_ ADAPTER DEFINITION) 
USER DEFINED 3(USE_ADAPTER_DEFINITION): 


START ATTACH MANAGER: 


Figure 28. Network Node Connected to Another Network Node 


7.15 Connection Network 


When you use a token-ring LAN you should use the connection network facility 
which is explained in section 9.2, “Connection Networks” on page 117. Only end 
nodes and network nodes may be on a connection network. 


An end node may belong to a connection network while its network node server 
does not, or is in a different connection network. 


The connection network name must be unique throughout all the LU names in 
the network. 


To define a connection network, you merely have to add the following verb in the 
.NDF files of the network nodes and end nodes (you must edit the files). 


Here, we call CONNETW1 the connection network and we use IBMTRNET adapter 
number Q1: 


Chapter 7. Sample Configurations 87 


DEFINE CONNECTION _NETWORK FQ_CN_NAME(USIBMRA.CONNETW‘1 ) 
ADAPTER_INFO( DLC_NAME(IBMTRNET) 


ADAPTER. NUMBER(1)):; 


Figure 29. Verb to Be Added in the .NDF file to Define the Node as Part of a Connection Network 


If you define an end node with the Create/Quick Configuration window, the end 
node .NDF file will automatically contain this verb for each configured token-ring 
LAN adapter, with the following parameters: 


¢ FQ CN _NAME: it is the C&SM LAN ID specified for the adapter in Communi- 
cations Manager under: | 


SNA feature profiles 
Data Link Control (DLC) profiles... 
IBM Token-Ring Network... 


e DLC NAME of the adapter 
¢ ADAPTER_NUMBER of the adapter. 


If you have two configured adapters and you only use one during the Quick Con- 
figuration, you will still have two connection network definitions, one for each 
adapter. 


If you intend to define many connection networks on the same token-ring LAN, 
you obviously cannot keep the default connection network name. You can 
define, however, many connection networks on the same token-ring LAN to parti- 
tion it. 


7.16 Network Node Acting as a Router between Two Token-Ring LANs 


A network node can act as a network level router for LU 6.2 session traffic 
between any of the supported Communications Manager DLC types whether they 
are two token-ring LANs, a token-ring LAN and an SDLC link, or a CSMA/CD 
LAN and an X.25 connection. 


We will now use a workstation with two token-ring LAN configured adapters and 
define it as a network node. Each adapter is on a different token-ring LAN. 
Simply follow these steps: 


1. Define the network node with the Configuration Management window: 


e Network node 
e Links to every node of each token-ring LAN. 


2. You may edit the .NDF file of the network node and add the definitions that 
allow it to serve one or two connection networks. 


3. Define the other workstations with the Create/Quick Configure window: 


e End node 
e Link to the router as preferred network node server. 


4. Edit the NDF of each workstation if you do not intend to keep the default 
names for the connection networks (C&SM LAN ID). 


If you have too many workstations on each token-ring LAN, do the following: 
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1. Define as many connection networks as you need on each token-ring LAN 
with a different network node server for each connection network 


2. Define a link from each network node server to the router node 
3. Define the links from the router node to each network node server 
4. For each network node server: 


e Define a link to every workstation it serves 
e Define in every workstation a link to its network node Server. 


This will cause sessions to be routed through intermediate nodes on the token- 
ring LAN. The network nodes (including the router node) do not have to be dedi- 
cated, but if they will be carrying much intermediate traffic users would notice 
their system being interrupted all the time. 


The .NDF File 

Here is the .NDF file of a network node router. On one token-ring LAN it is con- 
nected to another network node that could be a connection network server. On 
the other token-ring LAN it is a connection network server, serving one end 
node. 
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DEFINE _LOCAL_CP FQ_CP_NAME(USIBMMK.ROUTER ) 
_ DESCRIPTION(Created under PM) 
CP_ALIAS(ROUTER) 
NAU_ADDRESS(INDEPENDENT_LU) 
NODE_TYPE(NN) 
NODE_ID(X’22221’) 
HOST_FP_SUPPORT({NO); 


DEFINE_CONNECTION_ NETWORK FQ _CN_NAME(USIBMRA.BB119__) 
ADAPTER_INFO( DLC_NAME(IBMTRNET) 
ADAPTER_NUMBER(1)); 


DEFINE LOGICAL_LINK LINK_NAME(RALYOS2A) 
DESCRIPTION(NN of LAN #1) 
ADJACENT _NODE_TYPE(NN) 
PREFERRED_NN_SERVER(NO) 
DLC_NAME(IBMTRNET) 
ADAPTER_NUMBER(0) 
DESTINATION. ADDRESS(X’400000022222’) 
CP_CP SESSION SUPPORT(YES) 
ACTIVATE_AT_STARTUP(YES) 
LIMITED. RESOURCE(NO) 
LINK_STATION_ROLE(USE_ADAPTER_DEFINITION) 
SOLICIT SSCP_SESSION(NO) 
EFFECTIVE _CAPACITY(USE_ADAPTER_DEFINITION) 
COST PER CONNECT TIME(USE_ADAPTER_DEFINITION) 
COST PER BYTE(USE_ ADAPTER DEFINITION) 
SECURITY(USE_ADAPTER_DEFINITION) 
PROPAGATION DELAY(USE_ADAPTER_DEFINITION) 
USER_DEFINED 1(USE_ADAPTER_DEFINITION) 
USER_DEFINED 2(USE_ADAPTER_ DEFINITION) 
USER DEFINED 3(USE_ADAPTER DEFINITION): 


Figure 30 (Part 1 of 2). ‘Network Node Connected to Another Network Node 
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DEFINE LOGICAL LINK LINK NAME(SESBB119) 
DESCRIPTION(to EN with CP-CP connection in LAN #2) 
ADJACENT NODE_TYPE(LEARN) 
DLC_NAME(IBMTRNET) 

ADAPTER_NUMBER(1) 

DESTINATION ADDRESS(X’400032BB119B’) 
CP_CP_SESSION SUPPORT(YES) 

ACTIVATE_AT STARTUP(YES) 

LIMITED RESOURCE(NO) 

LINK_STATION ROLE(USE_ADAPTER_DEFINITION) 
SOLICIT SSCP_SESSION(NO) 


EFFECTIVE_CAPACITY(USE_ADAPTER_DEFINITION) 
COST_PER_CONNECT_TIME(USE_ADAPTER_DEFINITION) 
COST PER _BYTE(USE_ADAPTER_DEFINITION) 
SECURITY(USE_ADAPTER_DEFINITION) 
PROPAGATION DELAY(USE_ADAPTER_DEFINITION) 
USER DEFINED 1(USE_ADAPTER_DEFINITION) 
USER_DEFINED 2(USE_ADAPTER DEFINITION) 

( 


USER_DEFINED_3(USE_ADAPTER_DEFINITION); 


START_ATTACH MANAGER: 


Figure 30 (Part 2 of 2). Network Node Connected to Another Network Node 


7.17 Subarea Network and APPN Network 
An APPN network may use a subarea network: 


e Because the APPN network is split in pieces connected together through the 
subarea. 

e Because some transaction programs reside in the host and are intended to 
have conversations with transaction programs in the APPN network. 

e Because a focal point is implemented in the host, which is a tool to monitor 
the network (for example NetView). 


In all cases, the LU and mode names that are used for a conversation must be 
defined in the subarea network. 


The link that connects a node to the subarea contains the following parameter: 
ADJACENT NODE_TYPE(LEN). Also, there will be no CP name verification 
during the XID exchange. Thus you may specify any name for the partner node 
name in the link definition. 


However, if later you wanted to modify, with an editor, the parameter 

FQ ADJACENT _CP_NAME in the link definition, you must not forget to modify as 
well the parameter FQ OWNING CP_NAME in the PLU location definitions. If you 
use the Presentation Manager screens to do such a modification, both parame- 
ters are updated in the .NDF file. 
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7.18 Connection through a Subarea Network 


We suppose here that your APPN network is split into two pieces connected 
through a subarea. To make this connection, each piece must have a network 
node with a link to the subarea. Each piece is allowed to have one and only one 
connection into the subarea. We describe here how to configure such a network 
node. The network node sees the subarea as a LEN node. It acts as a server 
for the subarea. 7 


You must define, in the network node, all the PLUs that are located in the other 
part of the APPN network. Usually the PLUs will be defined with full or partial 
wildcards. You may only have one full wildcard in each part of the network. 
This is one reason why the partial wildcard is strongly recommended. Every LU 
you can reach with partial wildcards must begin with the same character(s). 
Therefore, using partial wildcards supposes that you have a naming convention 
for each part of the APPN network. 


We will now configure a network node so that every LU in the part of the APPN 
network where the node being configured is located can speak to: 


1. The LU-CP HENRILU1 
2. Every LU whose name begins with CLA, which are in the other part of the 
APPN network. | 


The following figure shows the network. We will configure the node RALYOS2A. 


to other node(s) 


CP = HENRILUIL CP = RALYOS2A 

LU2 : HENRLUI2 LU2 : RAKSNNI2 
HENRLUI3 RAKSNN13 
HENRLU14 


CP = CLAUDLUI 
LU6.2 : CLAUDLU2 


Figure 31. APPN Network Using a Connection through a Subarea 


We assume you know how to create a new .NDF file and how to use the Presen- 
tation Manager panels of Networking Services/2. If you don’t, “Creating Your 
.NDF File” on page 36 explains how to proceed. 


1. Go to the Configuration Management window and double-click on 
Configuration File. 
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2. If the name of the configuration file NDF you want to work with is not the 
name of the configuration file .NDF that is in the title bar of the Configuration 
Management window, open the configuration file you want to work with by 
selecting Open Configuration File... 


3. Keep or change the Local Node Characteristics, for example: 


Network ID: USIBMRA 

Local node name: RALY0S2A 

Local node ID: 22222 

Local node alias name: RALYOS2A (keep the node name) 
Node type: Network Node 

Activate Attach Manager at start up 

Comment: Created with the PM interface 

Click on OK to validate. 


4. Configure the connection(s) to this part of the APPN network. It may be 
connection(s) to end node(s) and/or network node(s). To have a simpler file 
we don’t define any connection here, so this part of the APPN network only 
contains the network node. 


5. Configure the connection to the subarea (which is seen as a LEN node): 


In the Connections window double-click on LEN Node. 


In the Adapter List window double-click on the currently configured 
adapter you want to use (we assume you use IBMTRNET adapter 00). 


Define the link, for example: 


— Link name: RAKNCP 

— Partner network ID: USTBMRA 

— Partner node name: RAK 

— LAN destination address: 400001240000 
— Comment: Link to SA20. 


Click on Define Partner LUs... if you intend to define PLUs in the other 
part of the APPN network (don’t forget the CPs that you may have to use 
as ordinary LUs). For example, we define: 


— The LU-CP HENRILU1 
- LU name: HENRILUI 
- Alias: HENRI 
- Comment: CP of the Network Node HENRILU1 
- Click on Update. 
— An LU from which we will define the wildcard 
- LU name: CLAUDLU1 
- Alias: CLAUDLU1 
- Comment: CP of the End Node CLAUDLUI 
- Click on Update. 
— Click on OK to validate the PLU definitions. 


Click on OK to validate the link definition. 


Close the Connections window. 


6. Define the advanced SNA capabilities of the node {LU, TP, Mode, etc...). 
7. Verify the configuration. 
8. Edit the .NDF file: 


In the DEFINE LOGICAL LINK verb: 
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— Change the ACTIVATE _AT_STARTUP to YES unless you intend to 
keep the default NO. | 
¢ Modify the DEFINE PARTNER _LU LOCATION verb issued for CLAUDLU1 
to define the partial wildcard: 


DEFINE PARTNER_LU LOCATION FQ PARTNER_LU NAME({USIBMRA.CLA _ ) 
DESCRIPTION(Wildcard to reach every LU whose name begins with CLA) 
WILDCARD_ENTRY{PARTIAL) 

FQ OWNING CP_NAME(USIBMRA.RAK) 
LOCAL NODE _NN_SERVER(YES); 


The .NDF File 
Here is the .NDF that has been created: 


Networking Services/2 


DEFINE LOCAL CP FQ CP_NAME(USIBMRA.RALYOS2A ) 
DESCRIPTION(Created with the PM interface) 
CP_ALIAS(RALYOS2A) 
NAU_ADDRESS(INDEPENDENT_LU) 
NODE_TYPE(NN) 

NODE_ID(X’22222’) 
HOST FP_SUPPORT(NO); 


DEFINE LOGICAL_LINK LINK_NAME(RAKNCP ) 
DESCRIPTION(Link to S$A20) 
FQ ADJACENT _CP_NAME(USIBMRA.RAK _ ) 
ADJACENT NODE_TYPE(LEN) 
DLC_NAME(IBMTRNET) 
ADAPTER_NUMBER(0) 
DESTINATION ADDRESS(X’400001 240000’) 
CP_CP SESSION SUPPORT(NO) 
ACTIVATE_AT STARTUP(YES) 
LIMITED. RESOURCE(USE_ADAPTER_DEFINITION) 
LINK STATION ROLE(USE_ADAPTER_DEFINITION) 
SOLICIT_SSCP_SESSION(NO) 
EFFECTIVE CAPACITY(USE_ADAPTER_ DEFINITION) 
COST PER CONNECT TIME(USE_ADAPTER_ DEFINITION) 
COST PER BYTE(USE ADAPTER DEFINITION) 
SECURITY(USE_ADAPTER_DEFINITION) 
PROPAGATION DELAY(USE_ADAPTER_DEFINITION) 
USER DEFINED 1(USE_ADAPTER_DEFINITION) 
USER DEFINED 2(USE_ ADAPTER DEFINITION) 
USER DEFINED 3(USE_ADAPTER_DEFINITION): 


DEFINE PARTNER_LU FQ PARTNER_LU_NAME(USIBMRA.HENRILU ) 
DESCRIPTION(CP of the Network Node HENRILU‘) 
PARTNER_LU_ALIAS(HENRI) 

MAX _MC_LL_SEND_ SIZE(32767) 
CONV_SECURITY_VERIFICATION(NO) 
PARALLEL_SESSION_SUPPORT(YES): 


DEFINE PARTNER LU FQ PARTNER _LU_NAME(USIBMRA.CLAUDLU‘ ) 
DESCRIPTION(CP of the End Node CLAUDLU1) 


PARTNER_LU_ALIAS(CLA) 

MAX _MC_LL_SEND_SIZE(32767) 
CONV_SECURITY_VERIFICATION(NO) 
PARALLEL_SESSION_SUPPORT(YES): 


DEFINE PARTNER_LU_ LOCATION FQ PARTNER_LU_NAME(USIBMRA.HENRILU‘1 ) 
DESCRIPTION(CP of the Network Node HENRILU‘) 
WILDCARD_ENTRY(NO) 

FQ OWNING CP_NAME(USIBMRA.RAK ) 
LOCAL NODE _NN_SERVER(YES); 


Figure 32 (Part 1 of 2). Network Node Used to Connect an APPN Network to a Subarea Network 
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DEFINE _ PARTNER_LU_ LOCATION FQ_PARTNER_LU NAME(USIBMRA.CLA ) 
DESCRIPTION(Wildcard to reach every LU whose name begins with CLA) 
WILDCARD_ENTRY(PARTIAL) | 
FQ OWNING CP_NAME(USIBMRA.RAK ) 


LOCAL NODE_NN_SERVER(YES); 


START_ATTACH_MANAGER; 


Figure 32 (Part 2 of 2). Network Node Used to Connect an APPN Network to a Subarea Network 


7.19 Connection with a Host 


To be able to establish a conversation between an LU 6.2 LU in the APPN 
network and an LU 6.2 LU in a host, both LUs must be known by VTAM™. 


The definition of the LU in the host is made in the network node that connects 
the APPN network to the subarea network. It is the same definition as for an LU 
that would be in another part of the APPN network that could only be reached 
through the subarea network: the LU is seen as being located in a LEN node. 
So, see section 7.18, “Connection through a Subarea Network” on page 92 
where the definition is explained (all the PLUs defined in this section could 
belong to the host). 


Example of .NDF File 
In this example we define two PLUs located in two different networks (different 
NETIDs). 
The Configuration Management window was used to build the .NDF file: 
1. Local Node Characteristics 


2. Connection to subarea (LEN) 


¢ Definition of the partner LUs in the hosts (there are partner LUs in dif- 
ferent hosts) 


3. Advanced SNA capabilities, we select: 


¢ Partner LUs (to change the NETID of the PLU in the other host) 
e Modes 
¢ CPi Communications Side Information. 


Here is the .NDF file. 


DEFINE LOCAL CP FQ CP NAME(USIBMRA.HENRILU1 ) 
DESCRIPTION{Network Node connected to the Host) 
CP_ALIAS({HENRILU1) 


NAU_ADDRESS(INDEPENDENT_LU) 
NODE_TYPE(NN) 

NODE _ID(x’22221’) 
HOST_FP_SUPPORT(NO): 


Figure 33 (Part 1 of 3). Network Node where Two PLUs Are Defined in Two Different Networks (SNI) 
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DEFINE LOGICAL _LINK LINK NAME(TOHOST ) 
DESCRIPTION(Link to the Subarea) 
FQ ADJACENT CP _NAME(USIBMRA.HOST ) 
ADJACENT NODE_TYPE(LEN) 
DLC NAME(IBMTRNET) 
ADAPTER_NUMBER(O) 
DESTINATION ADDRESS(X’400001240000’) 
CP_CP_SESSION SUPPORT(NO) 
ACTIVATE_AT STARTUP(NO) 
LIMITED RESOURCE(USE_ADAPTER_DEFINITION) 
LINK_STATION ROLE(USE_ADAPTER_DEFINITION) 
SOLICIT SSCP_SESSION(NO) 
EFFECTIVE CAPACITY(USE_ADAPTER_DEFINITION) 
COST_PER_CONNECT_TIME(USE_ADAPTER_DEFINITION) 
COST _PER_BYTE(USE ADAPTER_DEFINITION) 
SECURITY(USE ADAPTER_DEFINITION) 
PROPAGATION DELAY(USE_ADAPTER_DEFINITION) 
USER_DEFINED_1(USE_ADAPTER_DEFINITION) 
USER DEFINED 2(USE_ADAPTER_DEFINITION) 
USER_DEFINED 3(USE ADAPTER_DEFINITION); 


DEFINE_PARTNER_LU FQ PARTNER LU NAME(USIBMRA.CICSLOC ) 
DESCRIPTION(CICS local) 
PARTNER_LU_ALIAS(CICS31RA) 

MAX_MC_LL_SEND_ SIZE(32767) 
CONV_SECURITY_VERIFICATION(NO) 
PARALLEL_SESSION_SUPPORT(YES): 


DEFINE PARTNER_LU FQ PARTNER_LU NAME(USIBMRM.CICSREM ) 
DESCRIPTION(CICS in another network) 
PARTNER_LU ALIAS(CICSDEMO) 
MAX_MC_LL_SEND_SIZE(32767) 
CONV SECURITY _VERIFICATION(NO) 
PARALLEL SESSION SUPPORT(YES); 


DEFINE _PARTNER_LU LOCATION FQ PARTNER LU NAME(USIBMRA.CICSLOC ) 
DESCRIPTION(CICS local) 
WILDCARD_ENTRY(NO) . 
FQ OWNING CP_NAME(USIBMRA.HOST ) 
LOCAL_NODE_NN_SERVER(YES): 


DEFINE PARTNER_LU_LOCATION FQ _PARTNER_LU_NAME(USIBMRM.CICSREM ) 
DESCRIPTION(CICS in another network) 
WILDCARD_ENTRY(NO) 

FQ OWNING _CP_NAME(USIBMRA.HOST ) 
LOCAL NODE _NN_ SERVER(YES); 


Figure 33 (Part 2 of 3). Network Node where Two PLUs Are Defined in Two Different Networks (SN/) 
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DEFINE MODE MODE_NAME(MODE1  ) 
DESCRIPTION(Created with PM) 
COS_NAME(#CONNECT) 
DEFAULT_RU_SIZE(NO) 
MAX_RU_SIZE_UPPER_BOUND(1920) 
RECEIVE_ PACING WINDOW(8) 

MAX NEGOTIABLE SESSION _LIMIT(32767) 
PLU_MODE_SESSION_LIMIT(8) 
MIN_CONWINNERS_ SOURCE(4): 


DEFINE_CPIC_SIDE_INFO SYMBOLIC DESTINATION _NAME(CICS31 ) 


DESCRIPTION(CPIC for CICS local) 
PARTNER_LU_ALIAS(CICS31RA ) 
MODE _NAME(MODE1  ) 
TP_NAME(ACA1); 


DEFINE _CPIC_SIDE_INFO SYMBOLIC DESTINATION NAME(CICS _ ) 
DESCRIPTION({CPIC for CICS in another network) 
PARTNER_LU_ ALIAS(CICSDEMO ) 
MODE NAME(MODE1_ ) 
TP_NAME(ACA1); 


Figure 33 (Part 3 of 3). Network Node where Two PLUs Are Defined in Two Different Networks (SNI) 


7.20 Connection with a Primary Host 


A primary host is a host that contains a focal point, such as NetView, to monitor 
the network. Only one primary host may be defined. 


The primary host may be used to connect two parts of the APPN network. The 
primary host also may contain LU 6.2 LUs. 


In both cases the connection of a network node to the host is the same as 
explained in section 7.18, “Connection through a Subarea Network” on page 92 
and section 7.19, “Connection with a Host” on page 96 except that you must 
select Primary host instead of LEN. 


Example of .NDF File 


Here we show a network node with a link to a primary host. The Configuration 
Management window was used to build the .NDF file: 


98 Networking Services/2 


DEFINE LOCAL CP FQ CP _NAME(USIBMRA.HENRILU1 ) 
DESCRIPTION({Network Node connected to a Primary Host) 
CP_ALIAS(HENRILU1) 

NAU ADDRESS(INDEPENDENT LU) 
NODE_TYPE(NN) 
NODE_ID(X’22221’) 

HOST _FP_SUPPORT(YES) 

HOST _FP_LINK_NAME(PRIMHOST); 


DEFINE LOGICAL_LINK LINK _NAME(PRIMHOST) 
DESCRIPTION({Link to the Primary Host) 
FQ ADJACENT CP NAME(USIBMRA.ANYNAME ) 
ADJACENT NODE_TYPE(LEN) 
DLC_NAME(IBMTRNET) 
ADAPTER_NUMBER(O) 
DESTINATION ADDRESS(X’400001 240000’) 
CP_CP_SESSION SUPPORT(NO) 
ACTIVATE_AT STARTUP(YES) 
LIMITED. RESOURCE(USE_ADAPTER_DEFINITION) 
LINK_STATION ROLE({USE_ADAPTER_DEFINITION) 
SOLICIT SSCP_SESSION(YES) 
EFFECTIVE CAPACITY(USE_ADAPTER_DEFINITION) 
COST _PER_CONNECT_TIME(USE_ADAPTER_DEFINITION) 
COST _PER_BYTE(USE_ADAPTER_DEFINITION) 
SECURITY(USE_ADAPTER_DEFINITION) 
PROPAGATION DELAY(USE_ADAPTER_DEFINITION) 
USER DEFINED _1(USE_ADAPTER_DEFINITION) 
USER DEFINED 2(USE_ADAPTER_DEFINITION) 
USER_DEFINED 3(USE_ ADAPTER_DEFINITION); 


START_ATTACH MANAGER: 


Figure 34. Network Node Connected to a Primary Host 


7.21 VTAM/NCP Information 
This section contains information about the following: 


e Modes used in VTAM and Networking Services/2 

e« Classes of services in VTAM and Networking Services/2 
e PUs 

e LU 6.2 LUs 

e Other types of LUs. 


At the end of this section you will find a sample logon mode table and a sample 
VTAM list that were used for the configuration shown in Figure 31 on page 92. 
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Levels of VTAM and NCP That Support APPN 


To use a subarea network with an APPN network you must have at least the fol- 
lowing: 


e VTAM V3R2 
e SSP V3R4M1 
e NCP V4R3M1. 


The following table shows the PTFs that are needed to support different NETIDs. 


Table 1. ACF/VTAM* Support for Different NETIDS _ 


Release REL APAR P 
VTAM 3.2 


TF 

205 ~—«|.-: OY26312 
215. ——- | OY26327 
MVS/370 204 OY29600 
214 OY29603 
VM/SP 9370 321 (VM40123 
VSE G70 =| -DY39165 
VTAM 3.3 MVS/ESA’* 301 030487 


Modes 


MVS/XA 


The IBM-supplied modes of Networking Services/2 are: 


e “BLANK” (This is the series X’4040404040404040’ and not 
X’C2B3C1D5D2404040’. This is different from the AS/400.) 

e #BATCH 3 

e #BATCHSC 

« #INTER 

e #INTERSC. 


You may modify the definitions of these modes in your node. 


The modes CPSVCMG and SNASVCMG are architected modes and cannot be 
modified. | 


If the IBM-supplied modes of Networking Services/2 are not already defined in 
your VTAM logon mode tables, you may add them or create a special logon 
mode table. We have built such a table, MODAPPN, with the IBM-supplied 
modes for APPN and a mode we intend to use in our TPs: MODE1 (see Figure 35 
on page 103). 
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Class of Service 


PUs 


LU 6.2 


Unless you specify another mode, the default mode of Networking Services/2 is 
the blank mode. 


When a session goes through both an APPN network and a subarea network, it 
uses two classes of service (COS): 


1. In the APPN network the session uses the COS defined for the mode used by 
the transaction program. This definition is in the active configuration of the 
workstation. This COS is used to route the session in the APPN network. 


If you use the default blank mode, the associated COS is #CONNECT. 


2. In the subarea network the name of the COS may be written in the logon 
mode table, in the entry for the mode name used by the session. This COS 
name is used by VTAM to route the session through the subarea network. 


If you use the default blank mode or if you do not define any COS in an entry 
of your logon mode table, the COS defaults to the blank entry in the 
ISTSDCOS table. 


In both cases, each network uses the mode name to find the COS name. But the 
two COS names are not necessarily the same. 


A network node that connects to the subarea network must be defined to VTAM 
with a PU macro. The name you give to this PU in the VTAM list is not corre- 
lated with any name defined in Networking Services/2. 


You should not give a PU the name of the CP; you would not be allowed to 
define the CP as an LU, because the names must be unique in VTAM, whether 
they are PU or LU names. 


The PU macro must contain XID= YES to use an XID exchange during activation 
of the PU. This parameter is coded in the NCP major node. It must not be in the 
PU statement of a switched major node. 


For switched SNA devices you may use a new parameter in the PU macro: 
CPNAME=cccccccc. It specifies the CP name of the network node connected to 
the subarea. Either CPNAME or IDBLK and IDNUM must be specified on a 
switched PU definition statement. Both may be specified. The network node 
provides its CP name to VTAM in the XID exchange during the connection 
sequence. VTAM uses the CP name to locate the corresponding PU macro. If 
there is no PU macro with the corresponding CP name, VTAM uses IDNUM and 
IDBLK to locate the PU macro. Both ways of coding the PU macro are shown in 
Figure 36 on page 104. 


Independent LUs are defined to VTAM by coding LOCADDR=0. There can be as 
many LUs defined with LOCADDR=0 as you want. 


When you define the LUs of one of the parts of the APPN network to VTAM, you 


must define them as being in the network node that connects this part of the 
APPN network to the subarea network. 
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Other LUs 


Behind the PU macro of this network node, define each LU that you want to 
reach from the other part of the APPN network. Don’t forget that control points 
are LUs. Especially do not forget to define the CP of this network node behind 
the PU macro if you intend to establish sessions with it through the subarea 
network. 


An LU that is not defined in VTAM cannot be used as the destination for a 
session with another LU if this session must go through the subarea network. 
There is no effective way to get around it (such as the wildcards of APPN); VTAM 
must know the name of each destination LU. Without VTAM V3R4 you have to 
define every LU that will use the subarea. 


Since an APPN network is intended to change easily, you should define the LUs 
of the APPN network in a special major node whenever it is possible. You may 
also define in VTAM, LUs that do not exist yet. By doing so you will avoid stop- 
ping and restarting VTAM as frequently. 


If the network node uses its connection to the subarea network for 3270 emu- 
lation, the LU type 2 LUs of the 3270 emulation are defined in the same PU 
macro as the LU type 6.2 LUs of the APPN network. The link will also be used 
for the connection between the 3270 emulation and the host. 


In this case, the verification program APPNV will force the parameter 


SOLICIT_SSCP_SESSION to YES. This happens whatever the value of this 


parameter is in the .NDF file. You can verify the status of this parameter by 
selecting APPC -> Link Definition in the Display window. What is displayed is 
NOT what you have defined, but how your link is currently defined in the running 
configuration. However, you don’t have to worry about this change; it has no 
impact on the use of your APPN network. 


3270 emulation downstream from the network node is still accomplished the 
same way as without Networking Services/2. The definitions are still entered 
through the Communications Manager screens. That is because 3270 emulation 
does not use LU 6.2. The LUs of this node and all the LUs downstream from the 
network node are defined behind the PU macro for the network node. This 
includes: 


e The LU 6.2 LUs in this piece of the APPN network 
e The other LUs for 3270 emulation. 


When you install Networking Services/2 in a workstation that has 3270 emulation, 
you do not need to change the earlier VTAM definition, but only have to add the 
definitions for the LU 6.2 LUs into the PU macro of the network node that con- 
nects the APPN network to the subarea. 


Logon Mode Table (Example) 


Here is the sample logon mode table we used: 
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MODAPPN MODETAB 


* LOGMODE TABLE ENTRY FOR 0S/2 (31/01/91) 
KKEKRKKEKEKREKKREKEKEKEREKRKEKEKREREREKEEEKREREREKEEEKERERREREREKREKEKEKEREEEKKKERER 
BLANK  MODEENT LOGMODE=BLANK 
#BATCH MODEENT LOGMODE=#BATCH 
#BATCHSC MODEENT LOGMODE=#BATCH 
#INTER MODEENT LOGMODE=#INTER 
#INTERSC MODEENT LOGMODE=#INTER 
CPSVCMG MODEENT LOGMODE=CPSVCMG 
SNASVCMG MODEENT LOGMODE=SNASVCMG 
MODE1 | MODEENT LOGMODE=MODE1 
KEKEKREEKREREKEREREKEEKEERERREEKEREKEREREREREREEKRREEREKREREKREERKERKKKEREKRE 
MODEEND 
END 


Figure 35. MODETAB Used for LU 6.2 LUs 


VTAM List (Example) 


Here is the VTAM major node definition that we used: 


Chapter 7. Sample Configurations 103 


KEKRKERKEKREREKREREREREREREKREREEKEEREERREEKEEREREREKEREREEEREEREKKEEREREEKEEEREKE 


* VTAM SWITCHED MAJOR NODE FOR TRLAN-PS/2 ' 
KREEKREREKREREREEKEEREREEKEKREEREEREREERKRKEEEREREREREKRERREEREREREREERREEREERE 
SWKNNTR VBUILD TYPE=SWNET, REQUIRED 
MAXNO=7, REQUIRED 
MAXGRP=5 
** 
RAKUNNO] PU —- ADDR=13, COULD BE ANYTHING (NOT USED) 
IDBLK=05D, MATCH ON PS/2 FOR APPC STATION 
IDNUM=22222, SEND_XID PARAMETER 
DISCNT=NO, 
MAXOUT=1, 
MAXPATH=1, 
PUTYPE=2, 
VPACING=0 


** 


RAKENNO1 PATH GRPNM=EG24L00, 
DIALNO=400000022222, 


GID=1,PID=1 

Kk 

RALYOS2A LU — LOCADDR=0 ,MODETAB=MODAPPN FOR THE PS/2 LU6.2 
RAKSNN12 LU —- LOCADDR=2, FOR THE PS/2 EM LUA 


DLOGMOD=M2SDLCQ,MODETAB=AMODETAB, 
USSTAB=US327X, ISTATUS=ACTIVE 
RAKSNN13 LU — LOCADDR=3, FOR THE PS/2 EM LUB 
DLOGMOD=M2SDLCQ,MODETAB=AMODETAB, 
USSTAB=US327X, ISTATUS=ACTIVE 
** 
HENRI PU ADDR=13, COULD BE ANYTHING (NOT USED) 
CPNAME=HENRILU1, 
DISCNT=NO, 
MAXOUT=1, 
MAXPATH=1, 
PUTYPE=2, 
VPACING=0 
*K* 
RAKENNG2 PATH GRPNM=EG24L00, 
DIALNO=409000022221, 


GID=1,PID=1 
** 

HENRILU1 LU — LOCADDR=0 , MODETAB=MODAPPN FOR THE PS/2 LU6.2 
CLAUDLU1 LU LOCADDR=0 ,MODETAB=MODAPPN FOR THE PS/2 LU6.2 
CLAUDLU2 LU LOCADDR=0 ,MODETAB=MODAPPN FOR THE PS/2 LU6.2 
* 

HENRLU12 LU — LOCADDR=2, FOR THE PS/2 EM LUA 


DLOGMOD=M2SDLCQ ,MODETAB=AMODETAB, 
USSTAB=US327X, ISTATUS=ACTIVE 

HENRLU13 LU LOCADDR=3, FOR THE PS/2 EM LUB 
DLOGMOD=M2SDLCQ ,MODETAB=AMODETAB, 
USSTAB=US327X, ISTATUS=ACTIVE 

HENRLU14 LU LOCADDR=4, FOR THE PS/2 EM LUC 
DLOGMOD=M2SDLCQ ,MODETAB=AMODETAB, 
USSTAB=US327X, ISTATUS=ACTIVE 


Figure 36. VTAM Switched Major Node 
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7.22 Building a Sample APPN Network 


Using APPN to Network LAN Workstations 

For this example, we have chosen a “LAN connected to one or more subareas” 
scenario. In this scenario, every node on the sample piece of the APPN network 
is interconnected with a LAN. The subarea backbone is used to reach partners 
that are not on the LAN. 


Every node on the LAN is capable of having a connection with every other node 
on the LAN, but no one wants the administration cost of defining every node to 
every other node. That is why we included a connection network definition in 
this scenario. When a network node finds a partner LU during a search, it 
simply returns the LAN address of the partner LU to the originator. The origi- 
nator dynamically forms a logical connection with the specified address. No 
intermediate routing is required. 


In the examples below, we have used lowercase letters to represent variables. 
You should assume that these variables have a global scope. In other words, 
once a value is assigned to a variable, it must have the same value in every 
step where the variable appears. 


Make Some Simplifying Assumptions 
e Assume that, from some central location, you will build ASCII configuration 
files and distribute them to the LAN workstations. Each workstation operator 
will run APPNV to build the required configuration file. 


e Assume that you have already developed a naming convention for the 
network ID and LU names. (Remember, CP names are also LU names.) 


e To simplify this discussion, we will also assume that there is no security. 


Choose a Convention for Network Nodes 

The best conventions are those that place network nodes where administration 
can be done easily. For example, make the manager’s workstation a network 
node and make every other department workstation an end node. When a work- 
station enters or leaves the department, the manager makes a small change to 
his or her ASCII file. (Remember, you can always use APPNV /E to make incre- 
mental additions.) No one else is affected. For the following steps, we will 
assume that your convention has these properties. 


e Each end node is assigned to a network node. 


e Each LEN node is assigned to a network node. Remember, a subarea 
(sometimes called a composite end node) is treated as a LEN node. 


e For each subarea connected to the APPN network, there is one and only one 
connection to a network node. In addition, one subarea has been identified 
as the primary subarea (the subarea that contains the focal point). If you 
only have one subarea connection, obviously that would be the primary 
subarea. If your network is connected to more than one subarea, the 
primary subarea is normally the one that would require the most configura- 
tion if treated as a LEN node. 
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Defining a Network Node Configuration 
1. Define the control point: | 


DEFINE LOCAL CP 
FQ CP_NAME (aaaaaaaa. bbbbbbbb) 
CP_ALIAS(ccccccecc) 
NODE TYPE(NN) 
NODE _ID(X'ddddd'); 
where aaaaaaaa is the network ID (must be the same for all 
control points and LUs in this APPN network) 
bbbbbbbb is the control point (LU) name 
cccceccc is a local alias for LU name (normally it is 
a bad idea to choose the node's user name as 
an LU alias) 
ddddd is the node ID defined in VTAM for your 3270 
emulation connections or 00000 if you 
don't use 3270 emulation to VTAM 


2. Define the connection network. This allows your workstation to dynamically 
link to any other node on the same connection network. With this feature, no 
intermediate routing is used for sessions between workstations on this LAN. 


DEFINE CONNECTION NETWORK 
FQ CN NAME (aaaaaaaa. eeeeeeee) 
ADAPTER_INFO(dic_name(ffffffff),adapter_number(g)); 


where aaaaaaaa is the network ID 
eeeeeeee iS the connection network name (must be the same 
for all nodes on the LAN in this APPN network) 
ffffffff is name of the LAN DLC (for example, IBMTRNET) 
g is the adapter number (for example, 0) 


3. Define a logical link to a sufficient number of network nodes to support fault 
tolerance. There is no need for every network node to be connected to 
every other network node. For a large number of network nodes, the 
topology burden would be significant and pretty much useless on a LAN con- 
nection network. If you want to tolerate link failures, bridge failures, or node 
failures, there must be a “path” of CP-CP sessions from each network node 
to all other network nodes when the failure occurs. A common technique Is 
to connect the network nodes in a ring. In this case, each network node 
needs at least two connections plus additional connections for fault- 
tolerance. 


DEFINE LOGICAL LINK 
LINK NAME (hhhhhhhh) 
DLC_NAME (fff ff fff) 
ADAPTER_NUMBER(g) 

ADJACENT NODE_TYPE(NN) 
ACTIVATE _AT_STARTUP(YES) 
CP_CP_SESSION SUPPORT (YES) 


where ffffffff is name of the LAN DLC (for example, IBMTRNET) 
is the adapter number (for example, 0) 
hhhhhhhh is any link name unique in the node (for | 
example, the partner's CP name) 
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node 


4. Define a logical link to every end node assigned to this network node. This 
is not absolutely required, but it is a good convention. Even though a 
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network node is normally up all the time, there will be cases when the end 
node comes up and the network node is not up. In this case, these defi- 
nitions will force the network node to link to its end nodes when it comes 
back online. 


DEFINE LOGICAL LINK 


DLC_NAME(ffffffff) 

ADAPTER _NUMBER(g) 

ADJACENT NODE_TYPE(LEARN) 

ACTIVATE _AT_STARTUP(YES) 
CP_CP_SESSION SUPPORT (YES) 
DESTINATION ADDRESS (X'kkkkkkkkkkkk!) 5 


where ffffffff is name of the LAN DLC (for example, IBMTRNET) 
g is the adapter number (for example, 0) 
example, the partner's CP name) 
kkkkkkkkkkkk is the token-ring MAC address of the end 
node 


5. For every LEN node (that is, any node that does not support CP-CP sessions) 
assigned to this network node, define a logical link. Then define a partner 
LU location for each LU in that node. (This is how you support OS/2 Version 
1.2 nodes that have not migrated to Networking Services/2.) 


DEFINE LOGICAL LINK 
LINK _NAME(11111111) 
DLC_NAME (fff fffff) 
ADAPTER NUMBER (g) 
ADJACENT NODE_TYPE(LEN) 
ACTIVATE AT _STARTUP(YES) 
CP_CP SESSION SUPPORT (NO) 
DESTINATION ADDRESS (X'mmmmmmmmmmmm' ) 
FQ ADJACENT CP_NAME(nnnnnnnn.oocc0000) ; 


where ffffffff is name of the LAN DLC (for example, IBMTRNET) 

is the adapter number (for example, 0) 

11111111 is any link name unique in the node (for 
example, the partner's CP name) 

mmmmmmmmmmmm is the token ring MAC address of the LEN 
node 

nnnnnnnn is the network ID of the LEN node (if the LEN 
node is part of your network, then set nnnnnnnn 
equal to aaaaaaaa) 

ooooc00o0 is the CP name assigned to the LEN node 


(Note: Repeat this definition for every LU in the LEN node) 


DEFINE PARTNER LU LOCATION 
FQ OWNING CP_NAME(nnnnnnnn.ooooco00) 
FQ PARTNER LU NAME(nnnnnnnn. pppppppp) 
LOCAL_NODE_NN SERVER(YES); 
where nnnnnnnn is the network ID of the LEN node (if the LEN 
node is part of your network, then set nnnnnnnn 
equal to aaaaaaaa) 
ooo000000 is the CP name assigned to the LEN connection 
pppppppp is the name of the LU in the LEN node 


6. On one and only one network node, define a logical link and a wildcard 
partner LU location to the primary subarea. With this convention, the 
network will assume that any LU not found in the APPN network will be in 
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the subarea network. (The alternative is to define all the subarea LUs in the 
network node using a DEFINE PARTNER_LU_ LOCATION verb for each LU. 
(See the LEN node definitions above.) 


DEFINE LOGICAL LINK 
LINK_NAME (qqqqqqqq) 
DLC_NAME (fff fffTf) 
ADAPTER_NUMBER (g) 
ACTIVATE_AT_STARTUP(YES) 
CP_CP_SESSION SUPPORT (NO) 
DESTINATION ADDRESS (X'rrrrrrrrrrrr'‘) 
FQ ADJACENT CP_NAME(ssssssss.tttttttt) ; 


where ffffffff is name of the LAN DLC (for example, IBMTRNET) 

g is the adapter number (for example, 0) 

qqqqqqqq is any link name unique in the node (for 
example, the partner's CP name) 

rrrrrrrrrrrr_ is the token ring MAC address of the subarea 

ssssssss is the network ID of the subarea node (if the 
subarea node is part of your network, then set 
SSSSSSSS equal to aaaaaaaa) 

tttttttt is the CP name assigned to the subarea connection 


DEFINE PARTNER LU LOCATION 
FQ OWNING CP_NAME(ssssssss.tttttttt) 
WILDCARD_ENTRY (FULL) 

LOCAL_NODE_NN SERVER(YES) ; 


where ssssssss is the network ID of the subarea node (if the 
Subarea node is part of your network, then set 
SSSSSSSS equal to aaaaaaaa) 
tttttttt is the CP name assigned to the subarea connection 


7. Define the things required by applications that will run in the network node. 


e If the applications accept conversations started in partner logical units, 
you must either include DEFINE TP verbs or specify a directory for 
inbound attaches on a DEFINE DEFAULTS verb. 


e Ifthe applications allocate conversations and use the ALIAS parameter 
instead of the FQ PARTNER_LU NAME parameter, you must include 
DEFINE PARTNER_LU verbs. 


e If your applications use CPI-C and do not build their side information 
dynamically, you must include DEFINE CPIC SIDE_INFO verbs. 


e If your applications does not use the default or predefined modes, you 
must include DEFINE MODE verbs. | 


¢ If your applications require the sessions to be Pieaguaenees you must 
include CNOS verbs. 


8. Start the attach manager. 
START ATTACH MANAGER; 


Defining an End Node Configuration 
1. Define the control point. 
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DEFINE LOCAL CP 
FQ CP_NAME (aaaaaaaa. uuuuuuuu) 
NODE TYPE(EN) 
CP_ALIAS(vvvvvvvv) 
NODE ID(X'wwwww'); 


where aaaaaaaa is the network ID 
uuuuuuuu is the control point (LU) name 
vvvvvvvv iS a local alias for LU name (not the user) 
wWwWwWW is the node ID defined in VTAM for your 3270 
emulation connections or 00000 if you 
don't use 3270 emulation to VTAM 


2. Define the connection network. This allows your workstation to have a 
session with any other node on the LAN without going through an interme- 
diate node. 


DEFINE CONNECTION NETWORK 
FQ CN NAME (aaaaaaaa. eeeeeeee) 
ADAPTER_INFO(dic_name(ffffffff) ,adapter_number(g)); 


where aaaaaaaa is the network ID 
eeeeeeee 1S the connection network name 
ffffffff is name of the LAN DLC (for example, IBMTRNET) 
g is the adapter number (for example, 0) 


3. Define a logical link to this end node’s network node server. Through this 
connection, the end node will be able to locate every other LU in the 
network. 


DEFINE LOGICAL LINK 
LINK NAME (xxxxxxxx) 


DLC_NAME( TTT TTTFTT) 


ADAPTER_NUMBER (y) 

ADJACENT _NODE_TYPE(NN) 

ACTIVATE _AT_STARTUP(YES) 
CP_CP_SESSION SUPPORT (YES) 
PREFERRED NN SERVER(YES) 
DESTINATION ADDRESS (X'zzzzzzzzzzzz') ; 


where ffffffff is name of the LAN DLC (for example, IBMTRNET) 
y is the adapter number (for example, 0) 
XXXXXXXX 7S any link name unique in the node (for example the 
partner's CP name) 
ZZZZZZZZZZzz is the token-ring MAC address of the network 
node 


4. Define the things required by applications that will run in the end node. 


e Ifthe applications accept conversations started in partner logical units, 
you must either include DEFINE TP verbs or specify a directory for 
inbound attaches on a DEFINE DEFAULTS verb. 


e |f the applications allocate conversations and use the ALIAS parameter 
instead of the FQ PARTNER _LU NAME parameter, you must include 
DEFINE PARTNER_LU verbs. 


e If your applications use CPI-C and do not build their side information 
dynamically, you must include DEFINE CPIC_SIDE_INFO verbs. 


e If your applications does not use the default or predefined modes, you 
must include DEFINE MODE verbs. 


e |f your applications require the sessions to be preactivated, you must 
include CNOS verbs. 
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5. Start the attach manager. 
START_ATTACH MANAGER; 
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Chapter 8. Defaults Supplied by Networking Services/2 


The Networking Services/2 minimum configuration requirements for the node 
definitions (.NDF) file is the node name. This is because Networking Services/2 
has many definitions and functions already built-in for you, to make your node 
definition as simple as possible. By using these supplied features, you can sim- 
plify the configuration process immensely. 


At the end of this chapter you can find the defaults in effect if you don’t use the 
DEFINE _DEFAULTS verb. 


For additional information see Networking Services/2 Installation and Network 
Administrator Guide 


8.1 The Control Point LU 


When you configure your node name (using DEFINE_LOCAL_CP), you are also 
naming an LU in your node. This LU is known as the control point LU (CP-LU). 
You can specify an NAU address for your LU if it also needs to act as a 
dependent LU. You may also specify that the CP-LU should enforce LU-LU 
session security. You can choose to run all of your TPs on this LU, thereby elim- 
inating the need to define multiple local LUs. The CP-LU will control the CP-CP 
sessions with all other APPN nodes. 


8.2 IBM Supplied Class of Service (COS) Definitions 


The class of service {COS) that is used for a session depends upon what mode 
name is being used to establish the session. Networking Services/2 supplies 
five built-in class of service (COS) definitions to which a user mode may refer. 
You should rarely (if ever) have to build your own classes of service. The class 
of service (COS) definitions Networking Services/2 supplies for you are named: 


1. #BATCH 

. #BATCHSC 
. FCONNECT 
. #INTER 

. #INTERSC. 


o1 f& GW PM 


These names imply certain capabilities in the definitions. #BATCH and # INTER 
denote, respectively, definitions suitable for batch and interactive capabilities. 
The SC suffix means the definitions include security. #CONNECT implies general 
connection capability. 


Use the following guidelines for choosing a class of service: 


e Use #BATCHSC and #INTERSC only if you want to choose a secure logical 
link. The only secure logical links that Networking Services/2 supplies for you 
are through an X.25 network (if you have X.25 configured). Other links may 

_be designated as secure only if you change the default value (using the 
DEFINE_LOGICAL_LINK verb). 


e Use #BATCH and #INTER if some node along the route will regulate traffic 
based on the transmission priority for the COS. 
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e Use #CONNECT if there is nothing you need to regulate, or you just do not 
know what COS to use. 


Networking Services/2 will choose the optimum route of all available logical 
links to route traffic using the COS you choose. | 


8.3 IBM Supplied Modes 


The mode that a TP uses to allocate a session should be based on the associ- 
ated COS name, as well as other characteristics such as RU size and receive 
pacing window. Networking Services/2 supplies five built-in modes that you may 
use. These modes will choose an RU size tuned to the logical link computed for 
the route and a receive pacing window of 16. If the partner is an APPN node, 
adaptive pacing will be used which starts with a window size of one and changes 
dynamically. With these definitions you will rarely have to build your own mode. 
The modes Networking Services/2 supplies for your use are named: 


1. X’4040404040404040’ (the “blank” mode name - EBCDIC blanks) 
2. #BATCH 

3. #INTER 

4. #BATCHSC 

5. #INTERSC. 


These mode definitions that Networking Services/2 provides specify the matching 
COS name, except for the blank mode name, which specifies the COS name of 
H#CONNECT. This will help you choose your mode accordingly. 
Some reasons you may have to define your own mode are: 

e Your partner only supports single sessions. 

e Your TP is running on a dependent LU. 


e The supplied receive pacing window is inappropriate and adaptive pacing is 
not used. 


e Your TP uses a different mode name than what is supplied and the implicit 
mode capability is not used. 


8.4 Implicit Modes 
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Networking Services/2 also supports implicit modes for both inbound and out- 
bound requests. This means you can configure your node such that no mode - 
definitions are required at all (except for the five supplied for you). If you define 
a default mode for Networking Services/2, you can specify any mode name on 
outbound session requests and accept any mode name on inbound requests. 
Networking Services/2 will then build the mode dynamically using parameters 
specified for the default mode. Implicit mode parameters are obtained from the 
default mode name specified in the DEFINE_DEFAULTS verb. 


You may need to define a mode when: 


e The mode name used has parameters different than the default mode param- 
eters 


¢ You have not specified a default mode name on the DEFINE_DEFAULTS verb. 
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8.5 Implicit Logical Links 


Most Networking Services/2 node definitions will include verbs which define 
connectivity to adjacent nodes. There are, however, some situations in which an 
inbound connection attempt is made by an undefined adjacent node. This will 
typically happen as a result of one of the following scenarios: 


1. The partner is establishing the logical link using the connection network 
facility 


2. The partner has you defined as an adjacent node but you did not define your 
partner. This may occur when you have been defined to service requests for 
many adjacent nodes. However, if you are providing networking services for 
this node, by means of CP-CP sessions, both nodes should have connections 
to each other defined. 


When this occurs, Networking Services/2 will build an implicit logical link defi- 
nition for you. The implicit link name will start with an EBCDIC @ (X’7C’) char- 
acter, which makes implicit links easy to identify. 


8.6 Implicit Partner LUs 


8.7 Default TPs 


Networking Services/2 supports implicit partners for both inbound and outbound 
requests. This means you can define your node such that no partner LU defi- 
nitions are required at all. You can specify the fully-qualified partner LU name 
on outbound session requests and configure Networking Services/2 to accept 
inbound requests and build the partner LU dynamically. The implicit partner LU 
alias name will start with an ASCII @ {X’40’) character, which makes implicit 
partner LUs easy to identify. 


There may be good reasons to define partner LUs. Some of these are: 


¢ You want to refer to your partner LU with an alias name. 


e Your partner LU only supports single sessions, such as a pre-LEN subarea 
LU (subarea that only supports dependent LUs). 


e Your partner LU sends verified conversation security. 


e You have configured Networking Services/2 to accept BINDS only from the 
set of defined partner LUs (see the DEFINE_DEFAULTS verb). 


Networking Services/2 also provides the capability to start programs as a result 
of inbound allocation requests, even though no TP definitions exist for the pro- 
grams. To use this capability the program filename must match the inbound TP 
name. This means you can configure your node such that no TP definitions are 
required at all. When you enable the default TP capability for Networking 
Services/2, you can specify the following information about the TP: 


e Directory for inbound attaches - this is the directory where the TP program 
resides. You can also specify that the current OS/2 path be used to find the 
program by specifying DIRECTORY_FOR_INBOUND_ATTACHES("*) in the 
DEFINE_DEFAULTS verb. 


e Default TP operation - this lets you specify how the TP will be started: 


— Queued, attach manager started 
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— Queued, operator started 
— Queued, operator preloaded 
— Non-queued, attach manager started. 


e Default TP program type - this lets you specify what type of screen group the 
TP will use: 


— Presentation Manager 
— VIO-windowable 

— Full-screen 

— Background. 


¢ Default TP conversation security required - this lets you specify whether the 
default TPs require conversation security. 


The format and parameters for the DEFINE DEFAULTS verb can be found in 
Appendix A, “File APPNV.CTL” on page 191. More information on TPs can be 
found in ns2arp.. 


You may need to configure explicit TP definitions when: 


¢ The TP has different properties than the specified default values. 
e The TP program filename does not match the TP name. 
e You have not enabled the default TP capability. 


How Default TP Names Match the Filespecs of the TP Programs: 


Care should be taken in matching default TP names and the filespecs of the TP 

programs. The APPC attach manager uses the following algorithm to generate a 
filespec from the TP name carried in an inbound allocation request for a default 
TP: 


scan the first nine characters of the TP name for an EBCDIC period (X’4B’) 
or blank (X°40’). 
If a period is found: 
Use all the characters up to the period (a maximum of eight characters) 
plus up to three characters following the period until a bland is found, to 
form a filespec. 
Else if a blank is found: 
Use all the characters up to the blank (a maximum of eight characters) 
and append ’.EXE’. 
Else (if neither a period nor a blank is found): 
Use the first eight characters and append ’.EXE’. 


The following list shows some examples of inbound TP names and the corre- 
sponding program filespecs generated by the attach manager for default TPs: 


Inbound TP name Generated program filespec 
Program Program. EXE 

Program. Program. 

program.exe program.exe 

program.pjs yrogram.pjs 

LongTPName. JFW LongTPNa. EXE 


Note: Default TP names are case sensitive, just like configured TP names. 
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8.8 Implicit CNOS 


When partner LUs and modes are configured in Communications Manager 
without Networking Services/2 installed, the CNOS verb is built from the initial 
session limits profile and is issued when the Communications Manager is 
started. With Networking Services/2 installed, an implicit CNOS verb is issued 
any time there is a session request which requires initializing the session limits 
with a partner LU. With this facility, CNOS does not have to be configured, the 
TP does not have to explicitly issue a CNOS verb before allocating a conversa- 
tion, nor does CNOS have to occur before the TP is actually ready to be exe- 
cuted. The CNOS verb can be issued to defined partner LUs when Networking 
Services/2 is started by including a CNOS verb in the .NDF file for that partner. 
When a .CFG file with defined partner LUs is migrated (at installation time or 
with APPNMIG) CNOS verbs are built and included in the .NDF file for each 
defined partner LU. 


8.9 Default for the DEFINE DEFAULTS Verb 


If you don’t use the DEFINE_DEFAULTS verb in your .NDF file, the following are 
implicitly used: 


DEFAULT _TP_OPERATION(QUEUED_OPERATOR_ STARTED) 
DEFAULT _TP_PROGRAM_TYPE(BACKGROUND) 

DEFAULT _TP_CONV-SECURITY-RQD(NO) 
DEFAULT LOCAL _LU_NAME(local CP) 

IMPLICIT INBOUND _PLU_SUPPORT(YES) 
MAX_HELD_ALERTS(0) 

MAX _MC_LL_SEND_SIZE(0) 

DEFAULT MODE_NAME(blank) 


If you use the DEFINE_DEFAULTS verb in your .NDF file, without any parameters 
defined, the following are implicitly used: 


DEFAULT _TP_OPERATION(NONQUEUED AM_ STARTED) 

DEFAULT _TP_PROGRAM_TYPE(BACKGROUND) 

DEFAULT _TP_CONV-SECURITY-RQD(NO) 
DEFAULT LOCAL LU-ALIAS(the local CP becomes the default LU) 
IMPLICIT INBOUND PLU _SUPPORT(YES) 

MAX_HELD_ALERTS(10) 

MAX MC_LL SEND_SIZE(32767) 

DEFAULT MODE NAME(blank) 


Be aware that in both cases there is no default value for: 
DIRECTORY _FOR_INBOUND_ATTACHES 


When you migrate, a DEFINE_DEFAULTS verb is put in your .NDF file (see 
Figure 17 on page 62 in section 7.1, “End Node Obtained by Migrating an 
APPC-Configured .CFG File” on page 5/7). 


If you directly build the .NDF file, it is strongly recommended that you initially 
define the defaults from the Configuration Management window to avoid con- 
fusion over how the defaults will be set. To do so, select: Configure -> 
Advanced SNA... ->Transaction Program Defaults. 
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Chapter 9. Network Design Evolution 


This chapter describes how to make your current network take the maximum 
advantages of Networking Services/2 installation. 


Once Networking Services/2 is installed you have APPN available on your 
machines. Here are recommendations that you should consider before going 
further. 


9.1 How to Benefit from APPN 


Any APPC application that ran without Networking Services/2 will still run with it 
installed on the node. 


Once you have migrated your node to use Networking Services/2, delete all the 
DEFINE PARTNER_LU_ LOCATION verbs issued for the partner LUs that are in an 
end node or a network node: with APPN the partner LUs are dynamically found 
in the network. 


If you want to change your application or create new ones, you should take into 
consideration the following: 


e Keep in mind that the resources you use within APPN are the LUs, not the 
transaction programs. 


« Your control point is an LU. This LU is your local default LU unless you have 
specified another one during configuration (either under Communications 
Manager before you used the migration facility, or in your .NDF file if you 
built it directly). Whenever possible keep this LU as the local default. 


e If you have no reason for using another LU, do not define any other LUs and 
use only your control point LU: with modern implementations, parallel ses- 
sions and multiple links per node, there is no need for multiple local logical 
units. 


e The most prevalent requirement for multiple LUs comes from an application 
that needs simultaneous conversations to applications in a subarea that only 
supports dependent LUs (single session LUs). But even in this case, a 
clever design can permit the application to run on a single LU. 


¢ So the best design for a node (LEN, end node or network node) is to have 
only one local LU (the LU-CP) defined as default LU. 


e Since you have a local default LU, use it as often as possible. It will allow 
your transaction programs to be more easily carried from one node to 
another, no matter what the local default LU is. For example, the sample 
APPN program APPCTELL.EXE could not work on every node if it did not use 
the local default LU. 


9.2 Connection Networks 


The connection network is intended to spare a lot of routing overhead when you 
have network nodes and end nodes on a token-ring LAN. 
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Concept 


Without APPN, an LU had to know the address on the token-ring LAN (MAC 
address) of each of its partner LUs. With the APPN directory and connection 
networks these addresses can be retrieved from the network node server 
dynamically. 


The concept of connection network makes possible a direct session between any 
two nodes located on the same token-ring LAN with only a single definition for 
the connection network on each node. When an LU wants to establish a session 
with another LU, it uses the APPN directory services to locate the other LU. 
When the LU is in another node an end node’s directory service will ask its 
network node server to locate the LU. The network node does a distributed 
search and locates the LU. Included in the results from the search are the con- 
nections from the node containing the LU into the APPN network (including the 
connection network and its MAC address). The network node server calculates 
the best route for the session (the connection network) and passes the route 
(including the destination MAC address) back to the LU wanting to initiate the 
session. The first node can then dynamically create a link to the second node 
(this link will always be deleted at the end of the session). Thus the session will 
not be routed through any intermediate node. 


You must only be sure that the same connection network name is assigned to 
each node of the token-ring LAN that wants to use this service. Only end nodes 
and network nodes may use connection networks. Links to LEN nodes must still 
be defined. 


Why are connection networks so important? The answer is simple: if you have 
APPN installed on a token-ring LAN without any connection network, then only 
the links you have defined will be used. If you have not defined links between 
any two end nodes then the network nodes will have to do intermediate routing 
for the end nodes attached to them. It means that the data exchanged between 
two end nodes on a common token-ring LAN will still be routed through network 
nodes. 


By using a connection network you avoid this heavy routing overhead on your 
network nodes. 
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Figure 37. Connection Networks 


Configuration 
To define a connection network you must consider the following: 


End Node Configuration 
You should use the following verbs for each end node definition: 


e DEFINE LOCAL CP 

e DEFINE CONNECTION NETWORK 

e DEFINE LOGICAL LINK (with the network node server) 
e DEFINE DEFAULTS (enable your defaults) 

¢ START _ATTACH MANAGER. 
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Utilization 


Network Node Configuration 
You should use the following verbs for the network node server definition: 


e DEFINE LOCAL CP 

e DEFINE CONNECTION NETWORK 

e DEFINE DEFAULTS enable your defaults 

e DEFINE LOGICAL LINK {with any “adjacent” network nodes). 
e Include the following for each served end node: 


— DEFINE _LOGICAL_LINK 
e START_ATTACH_ MANAGER. 


Each connection network name must be unique within the LU names of the APPN 
network. 


Communications Manager allows only 64 link stations per token-ring adapter. 
Therefore no more than 128 end nodes can be attached to the same network 
node on a token-ring LAN {with two adapters in the workstation). 


If you want to have more workstations on your token-ring LAN, or if you don’t 
want to attach so many end nodes to a network node, you must define multiple 
network node servers on the token-ring LAN and then connect the network 
nodes together. All these network nodes may belong to the same or to different 
connection networks. 


You may have one node with two adapters on the same connection network. 


DEFINE CONNECTION NETWORK FQ CN _NAME(NET.CONNET) 
ADAPTER_INFO( DLC_NAME(IBMTRNET) 


ADAPTER_NUMBER(0)) 
ADAPTER_INFO( DLC_NAME(IBMTRNET) 
ADAPTER_NUMBER(1)): 


Figure 38. Node with Two Adapters on the Same Connection Network 


However, you must be careful. In a valid connection network all adapters must 
be able to access all other adapters on the same connection network. Thus, in 
the preceding figure both adapters must be on the same token-ring LAN. 


You can also have one node with two adapters defined on two different con- 
nection networks. These connection networks may be on the same token-ring 
LAN or on two different token-ring LANs. 


DEFINE CONNECTION NETWORK FQ_CN_NAME(NET.CONNETO) 
ADAPTER_INFO( DLC_NAME(IBMTRNET) 
ADAPTER_NUMBER(O)):; 


DEFINE CONNECTION NETWORK FQ _CN_NAME(NET.CONNET1) 
ADAPTER_INFO( DLC_NAME(IBMTRNET) 
ADAPTER_NUMBER(1)): 


Figure 39. Node with Two Adapters on Different Connection Networks 
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There is no requirement for an end node and its network node server to both be 

on the same connection network. An end node and its network node server may 
belong to different connection networks or the end node can be connected to its 

serving network node by a different link type (for example, SDLC). 


Defining multiple connection networks on the same token-ring LAN is a way of 
partitioning your token-ring LAN. 
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Figure 40. Partitioning a Token-Ring LAN 


Connection network links are automatically defined as limited resources. Even if 
you specify free unused link =NO in the token-ring DLC adapter profile of the | 
SNA feature profile of Communications Manager, this default will be overwritten 
when the logical link is defined by Networking Services/2. See sections 7.15, 
“Connection Network” on page 87 and 7.16, “Network Node Acting as a Router 
between Two Token-Ring LANs” on page 88 for examples of connection net- 
works being defined. | 


9.3 How to Define Links between End Nodes and a Network Node Server 


Networking Services/2 allows the situation in which you only define the links 
between an end node and its network node server in the end node. The network 
node learns about the end node when the end node is powered on. The end 
node dynamically create a logical link to the server and all goes well. 


So it would seem you don’t have to define the end nodes to their server which in 
fact would be much less work. However, it is strongly recommended that you do 
define the end nodes to their network node server if you don’t want to encounter 
problems. 


To understand why a network node should define the links to all the end nodes it 
serves, consider this scenario. 


1. The network node does not have the recommended link definitions to the 
end node. : 
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2. The network node is activated. — 


3. The first three end nodes are activated. Their link definitions cause them to 
automatically connect to their network node. The network node provides 
them with the standard APPN services: search for LU locations, compute 
optimal routes, and provide intermediate routing when necessary. 


4. The network node is deactivated for maintenance. The first three end nodes 
lose their network node connection. Existing sessions that are not routed 
through the network node are not affected, but there is no APPN service for 
new sessions. 


5. The second three end nodes are activated. Since the network node is not 
active, they cannot link to it and they cannot get any APPN services for 
starting new sessions. 


6. The network node is reactivated. Since it does not contain the link definitions 
for its end nodes, it does not try to link to them automatically. And since the 
end nodes are already active, they will not make another attempt to link with 
the network node. So, even though the network node is active, none of the 
end nodes will be able to get APPN services from it. Manual intervention is 
required to reconnect the end nodes to the network node. 


Now consider the same scenario when the network node has the recommended 


link definitions. When the network node is reactivated in step 6, it will automat- 


ically link to each of its end nodes, and the end nodes will have access to the 
APPN services. NO manual intervention is required. 


9.4 Routing between Token-Ring LANs 
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Since the same network node may belong to two different token-ring LANs, it 
provides an easy way to get a route between two token-ring LANs. 


If you intend to have connection networks on each token-ring LAN, the con- 
nection network names must be different except if there is a bridge between the 
token-ring LANs. 


Figure 41. Routing between Token-Ring LANs 


Networking Services/2 supports routing between DLCs for LU 6.2 applications 
only. See section 7.16, “Network Node Acting as a Router between Two Token- 
Ring LANs” on page 88 for an example of this. 
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Chapter 10. Management Services 


Networking Services/2’s management services capability is an implementation of 
the SNA management services architecture. Details about this architecture are 
found in the /BM Systems Network Architecture Management Services Reference. 
An overview of some of the concepts will be presented along with Networking 
Services/2’s implementation and the significance of this in today’s networks. 
Also, see Chapter 11, “AS/400 Considerations” for some network management 
considerations when an AS/400 is included in the network. 


10.1 Management Services Architecture Level 


The management services architecture has been evolving with time. Therefore, 
products have implemented different levels of the architecture. The levels of the 
architecture we are concerned with are: 


MDS-level 
An SNA product that can send and receive Multiple Domain Support 
Message Units (MDS _MUs) between a focal point (FP) and an entry point 
(EP). The MSD _MUs may flow on an LU-to-LU session using the 
SNASVCMG mode or (between an end node and its network node server) 
on a CP-to-CP session. This is the most recent level of the architecture. 
NetView Version 2 Release 2 will implement this level as a focal point. 


Networking Services/2 has implemented this level as an entry point. 


migration-level 
An SNA product that can send and receive Control Point Management Ser- 
vices Units (CP_MSUs) but not MDS _MuUs. As a focal point it only supports 
the Alert MS category. OS/400 Release 3 Modification Level 0 has imple- 
mented this level of the management services architecture as both a focal 
point and an entry point. 


Networking Services/2 does support transforming Alert MDS MuUs into 
CP_MSUs and forwarding them to a migration-level focal point (an AS/400). 


NMVT-level 
An SNA product that can send and receive NMVTs, but not MDS_MUs or 
CP_MSUs. These NMVTs will flow on the SSCP-to-PU session. Among the 
products to implement this level are NetView Version 2 Release 1 (and 
earlier) and OS/2 Extended Edition without Networking Services/2 installed. 


Networking Services/2 does support transforming from MDS _MUs and 
CP_MSUs to NMVTs and back when the focal point is in a host and the 
NMVTs flow on an SSCP-to-PU session. Also, the transformation takes 
place when a management services application (such as LAN Manager) 
wants to send an Alert NMVT and the focal point is a migration-level focal 
point (AS/400) or an MDS-level focal point (NetView Version 2 Release 2). 
For more information on how the transformations are done see the /BM 
SAA Networking Services/2 Installation and Networking Administrator 
Guide. 
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10.2 Focal Point, Service Point, and Entry Point Relationships 


We have been using the terms focal point and entry point without having defined 
what they are. Here is a brief description: 
Focal Point (FP) | 
A focal point is a central point of eoniret for managing a network. It can 
request data from service points and entry points relating to the operation 
of a network. It can also receive unsolicited data from the nodes it 


manages. NetView and AS/400 have implemented the focal point capa- 
bility. 


Entry Point (EP) 
An entry point captures local management services data and sends it to a 
focal point for processing, either upon request or unsolicited. Networking 
services/2 Prowce enue entry point function. 


Service Point (SP) 
A service point is support for requesting and capturing data from devices 
that, by themselves, cannot serve as an entry point. Except that it collects 
non-local data, a service point functions like an entry point in its relation- 
ship to a focal point. The IBM NetView/PC and IBM LAN Manager program 
products provide service point function. Networking Services/2 provides 
programming support for these and other management services applica- 
tions. 


A relationship is established between a focal point and an entry point for a given 
management services category {such as Alerts) by exchanging MS Capabilities 
messages. The collection of entry point nodes that have an explicit or default 
focal point-to-entry point relationship with the same focal point for an MS cate- 
gory make up the focal point’s sphere of control, or SOC, for that category. Each 
of these entry point nodes is called a SOC node. Networking Services/2, as a 
network node or end node, can be a SOC node for the Alert MS category. 


The following are the types of focal point-to-entry point relationships possible: 


Explicit 
This relationship is established when an operator at a focal point assigns 
an entry point node to the focal point’s SOC. The focal point initiates the 
exchange of MS Capabilities to establish the explicit focal point-to-entry 
point relationship. The entry fom node can be a network node or an end 
node. 


The relationship between the Networking Services/2 network node entry 
point and the AS/400 focal point in “Alert Processing on PS/2, AS/400 and 
NetView” on page 154 is an explicit focal point-to-entry point relationship. 


Implicit (Primary) 
This relationship is established when an operator at an entry point assigns 
that node to the focal point’s SOC. The entry point initiates the exchange 
of MS Capabilities to establish the implicit (primary) focal point-to-entry 
point relationship. The entry point node can be a network node or an end 
node. 


Networking Services/2 does not support this. There is no way to request 
NS/2 to initiate the MS Capabilities exchange. NS/2 will only initiate the 
MS Capabilities exchange when it loses its explicit or implicit (primary) 
focal point, and a backup focal point has been defined. 
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Implicit (Backup) 


This relationship is established when the entry point acquires a backup 
focal point after an explicit or implicit primary focal point becomes unavail- 
able. The entry point initiates the MS Capabilities exchange. A backup 
can only have been specified when both the entry point and the focal point 
are at the MDS-level. 


Default 


This relationship is established when a focal point acquires the entry point 
automatically without network operator definition (for example, an AS/400 
can be defined as a default focal point and will initiate the MS Capabilities 
exchange with a network node when it is added to the topology database in 
the AS/400). The focal point initiates the MS Capabilities exchange. 


Domain 


This relationship is established when a network node server informs the 
entry point that is an end node in the network node’s domain of the focal 
point. The network node sends the MS Capabilities to the end node to 
establish the domain relationship. 


Networking Services/2 supports this relationship for all three levels of focal 
point. 


Host 


This relationship is used when the entry point node can have an 
SSCP-to-PU session and this session is used to transport NMVTs to the 
management services application in the host. 


Networking Services/2 supports being an entry point in a host relationship 
when it is boundary-attached to the subarea network. You should specify 
YES for the host-FP-support configuration option. 


10.3 Focal Point-to-Entry Point Relationship Hierarchy 


There is a possibility for more than one focal point being available to an entry 
point for a particular management services category. For example, Networking 
services/2 might be configured to have a host focal point using the SSCP-to-PU 
session. Ata later time an AS/400 focal point might send the Networking 
Services/2 an MS Capabilities offering to be the Alert focal point. This explicit 
focal point would take precedence over the host focal point. 


The hierarchy for focal points is: 


1. 


An explicit focal point replaces any active focal point-to-entry point relation- 
ship. 


. A default focal point replaces a host focal point-to-entry point relationship, 


but not an explicit or implicit (backup) relationship. 


. A domain focal point replaces a host focal point-to-entry point relationship, 


but not an explicit or implicit (backup) relationship. 


. A host focal point does not replace any other relationship. It can only be 


started when Networking Services/2 is started, and remains active only until 
an explicit, default, or domain focal point-to-entry point relationship (if any) is 
established. If one of these other relationships is started and then that focal 
point becomes unavailable, Networking Services/2 cannot go back to using 
the host focal point-to-entry point relationship unless Networking Services/2 
is stopped and restarted. | 


Chapter 10. Management Services 125 


10.4 Management Services for a Sample Network 


To understand some of the implications of what is and is not supported for 
network management, let us look at a sample network and see how we might 
want to manage Alerts from this network. Let us assume that in Figure 42 we 
want all alerts to be sent to a NetView operator in the host. 


A 
NetView 
Host 


~VTAM 


B c 
NCP NCP 
D : F G r 
AS /406 NS /2 0S /2 NS /2 NS /2 
NN EN LEN NN LEN 
I J K L | oy 
NS /2 NS /2 NS /2 NS /2 0S /2 
NN EN EN | | NN LEN 
N 0 p Q R 
NS /2 NS /2 | NS 72 NS /2 NS /2 


Figure 42. Sample Network for Management Considerations 


Your options for how Alerts can get to the NetView operator vary depending on 
where you are in the network. 
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Boundary-Attached End Nodes and LEN Nodes (Nodes E, F, and H) 


This section discusses the options for nodes E, F, and H. OS/2 LEN nodes (node 
F) and NS/2 end nodes (node E) or LEN nodes (node H) can be configured to 
request SSCP-PU session activation. There is really no difference between the 
NS/2 end node (node E) and the NS/2 LEN node in this figure because our defi- 
nition of an NS/2 LEN node is an end node without CP-to-CP sessions and 
neither node will have CP-to-CP sessions with a network node. 


When configuring NS/2 nodes (end nodes or network nodes) that are boundary 
attached to the subarea and are to use the SSCP-to-PU session for network man- 
agement, you need to specify the following in the .NDF file: 


1. HOST _FP_SUPPORT(YES) on the DEFINE LOCAL CP verb 


2. HOST_FP_LINK_NAME(link-name for link to host) in the DEFINE LOCAL CP 
verb 


3. SOLICIT SSCP_SESSION(YES) on the DEFINE LOGICAL LINK verb for the 
link to the host. 


For an example of this for a network node see section 7.20, “Connection with a 
Primary Host” on page 98. It is the same for an end node except that it would 
be NODE_TYPE(EN) on the DEFIND-LOCAL_CP verb. If you are token-ring 
LAN-attached, your C&SM LAN ID will be displayed as your RESOURCE ID in 
NetView, so you want to make it something meaningful. This is host focal point 
support. Host focal point support is the only way the OS/2 LEN node (node F) 
can receive network management support. 


If you have an AS/400 somewhere in your APPN network (node D} and the CPs 
for nodes E and H are defined to VTAM, you can add nodes E and H to the 
AS/400’s SOC and the AS/400 will initiate a focal point-to-entry point relationship 
with nodes E and H and take over focal point services for these nodes. The 
AS/400 can also be set up to route alerts that it receives up to NetView in host A 
on the AS/400’s SSCP-to-PU session. Nodes E and H have to be explicitly added 
to the AS/400’s SOC before this relationship will be established. 


For more information on how to add and remove entries to the AS/400’s SOC 
see “Alert Processing on PS/2, AS/400 and NetView” on page 154. 


Boundary-Attached Network Nodes and End Nodes in Their Domain (Nodes G 
and K) 


This section discusses the options for nodes G and K. An NS/2 network node 
can be configured to request SSCP-to-PU session activation. When configuring 
NS/2 network nodes that are boundary-attached to the subarea and are to use 
the SSCP-to-PU session for network management, you need to specify the fol- 
lowing in the .NDF file: 


1. HOST_FP_SUPPORT({YES) on the DEFINE LOCAL _CP verb 


2. HOST _FP_LINK_NAME(link-name for link to host) in the DEFINE LOCAL CP 
verb 


3. SOLICIT SSCP_SESSION(YES) on the DEFINE _LOGICAL LINK verb for the 
link to the host. 


For an example of this for a network node see section 7.20, “Connection with a 
Primary Host” on page 98. If you are token-ring LAN-attached, your C&SM LAN 
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ID will be displayed as your RESOURCE ID in NetView, so you want to make it 
something meaningful. | 


An NS/2 network node (node G) will initiate the MS Capabilities exchange with 
end nodes in its domain (node K) for focal point support. This allows the end 
node to send alerts on the CP-to-CP session to its serving network node. The 
serving network node will then send the alert on to the focal point (in this case 
on the SSCP-to-PU session to host A). This is domain focal point support. 


If you have an AS/400 somewhere in your APPN network (node D) and the CP for 
node G is defined to VTAM, you can add node G to the AS/400’s SOC and the 
AS/400 will initiate a focal point-to-entry point relationship with node G and take 
over focal point services for this node. Node G will then do a new MS Capabili- 
ties exchange with end node K. Node G will now have an expiicit focal point 
relationship with the AS/400 and node K will still have a domain focal point 
relationship, but now the AS/400 will be the focal point. The AS/400 can also be 
set up to route alerts that it receives up to NetView in host A on the AS/400’s 
SSCP-to-PU session. Node G has to be explicitly added to the AS/400’s SOC 
before this relationship will be established. 


If the CP for node K is defined to VTAM, you can also add node K to the 
AS/400’s SOC. This would cause the AS/400 to initiate an MS Capabilities 
exchange directly with end node K causing an explicit focal point-to-entry point 
relationship to be established between the AS/400 and end node K. 


For more information on how to add and remove entries to the AS/400’s SOC 
see “Alert Processing on PS/2, AS/400 and NetView” on page 154. 


LEN Nodes That Are Not Boundary-Attached (Nodes M and R) 


This section discusses the options for nodes M and R. 


There is currently no way for LEN nodes to send alerts to the host if they are not 
boundary-attached to the subarea. 


NS/2 End Node Attached to an AS/400 (Node J) 


This section discusses the options for node J. 


An end node attached to an AS/400 network node is part of the domain of the 
AS/400. The AS/400 will initiate the MS Capabilities exchange with the end node 
(node J) establishing a domain focal point-to-entry point relationship. 


Network Nodes That Are Not Boundary-Attached with AS/400 (Nodes I and O) 
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This section discusses the options for nodes | and O. 


Network nodes that are not boundary-attached to the subarea network do not 
have an SSCP-to-PU session and therefore cannot send network management 
information to the host by that session. If, however, the network node that 
attaches this group of nodes to the subarea is an AS/400 (node D) the AS/400 
can function as the focal point for the network nodes and forward the alerts to 
the host. 


If the AS/400 is defined to be a default focal point, then when the NS/2 network 
node (node | or node O) is added to the network, then the AS/400 network node 
will find out via the topology database update (TDU). The TDU will cause the 
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AS/400 to initiate an MS Capabilities exchange with the newly added network 
node and establish a default focal point-to-entry point relationship. The NS/2 
network node would then initiate an MS Capabilities exchange with end nodes in 
its domain (end node N is in network node I|’s domain) establishing a domain 
focal point-to-entry point relationship. 


If a default focal point is not defined, then you will have to explicitly add the NS/2 
network nodes to the AS/400’s SOC. Even if a default focal point does exist, you 
can still explicitly add the NS/2 network nodes (nodes | and O) and the NS/2 end 
node (node N) to the AS/400’s SOC. 


For more information on how to add and remove entries to the AS/400’s SOC 
see “Alert Processing on PS/2, AS/400 and NetView” on page 154. 


Network Nodes That Are Not Boundary-Attached without AS/400 (Nodes L and 
Q) 


This section discusses the options for nodes L and Q. 


Network nodes that are not boundary-attached to the subarea network do not 
have an SSCP-to-PU session and therefore cannot send network management 
information to the host by that session. If, however, there is an AS/400 network 
node (node D) in the APPN network acting as a focal point, and the CPs for the 
NS/2 network nodes (nodes L and Q) are defined to VTAM, then the AS/400 can 
establish explicit focal point-to-entry point relationships with the network nodes 
and the AS/400 can forward the alerts to the host. 


If the AS/400 is not in the same group of nodes (you have to traverse the 
subarea network to get to it) then it cannot be defined as a default focal point, 
and you would have to explicitly add the NS/2 network nodes to the AS/400’s 
SOC, causing the AS/400 to initiate an MS Capabilities exchange, thus estab- 
lishing an explicit focal point-to-entry point relationship. The NS/2 network node 
would then initiate an MS Capabilities exchange with end nodes in its domain 
(end node P is in network node L’s domain) establishing a domain focal point-to- 
entry point relationship. 


You could also explicitly add the NS/2 end node to the AS/400’s SOC initiating a 
new MS Capabilities exchange between the AS/400 and the NS/2 end node (node 
P) establishing an explicit focal point-to-entry point relationship. 


For more information on how to add and remove entries to the AS/400’s SOC 
see “Alert Processing on PS/2, AS/400 and NetView” on page 154. 


10.5 Automating the Entry of Nodes to the AS/400’s SOC 


When a network node is in the same part of an APPN network as an AS/400 
node (no subarea links in between) the AS/400 can be set up to automatically 
establish a default focal point-to-entry point relationship. If, however, the AS/400 
is in another part of the network (subarea links in between), then the AS/400 will 
not know when these nodes join the network. This means that when the network 
node powers up, a network operator command has to be executed on the AS/400 
to add the node to the AS/400’s SOC. 


The commands for adding or removing a node from the AS/400’s SOC can be 
issued from an APPC transaction program. If the startup.cmd file of an NS/2 
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network node started a transaction program that established a conversation with 
a transaction program on the AS/400, informing the AS/400 that it desired to be 
added the the AS/400’s SOC, then the NS/2 network node would be added to the 
AS/400’s SOC every time NS/2 was started. 
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Chapter 11. AS/400 Considerations 


This chapter assists the customer in using APPN in both the OS/2 environment 
and in the AS/400 environment to increase connectivity, reduce system defi- 
nition, ease network operation, and simplify network design. The connection 
between Networking Services/2 and the AS/400 is looked at as well as consider- 
ations for 5250 emulation and AS/400 PC Support. 


This chapter will start with some general considerations and then there will be 
some examples of configuring Networking Services/2 for connection to the 
AS/400 and configuring the AS/400 on the other side. 


11.1 General AS/400 Considerations 


PC Support and OS/400 Driver Levels 
The AS/400 PC Support (both OS/2 and DOS) used for testing was Release 3.0. 


OS/400 was at Version 1, Release 3, Modification level 0. In addition, we had 
installed CUMulative PTF package TC91025, which was made available January 
25th, 1991. 


PC Support and OS/400 Fix Reports 


Rel 3.0 PC Support INSTALL.EXE Trap ’000D’x 
When we attempted to install the OS/2 version of PC Support onto one of our 
PS/2s*, we received a TRAP ’O00D’x error: 


SYS1943: A program caused a protection violation. 


TRAP 000D 


This was caused by the OS/2 INSTALL.EXE program attempting to modify the 
CONFIG.SYS file which had very long (over 122 characters) PATH or LIBPATH 
statements. A fix has been provided for this problem: LF70605, which is part of 
the CUM PTF package TC91025. 


To make a new OS/2 install disk (for single byte systems): 


1. Make sure LF70605 is installed on your AS/400. 

2. Insert a blank, formatted diskette into the A: drive of a PS/2 that has PC 
Support running to the AS/400. 

3. Type “I:\COPYPCS A:”. 

4. Use this new disk to install PC Support. 


Rel 3.0 OS/400 Connection Network Routing PTF 

Before you attempt to use the AS/400 as a network node in a network that has a 
connection network you should load PTF MF02095 onto the AS/400. MFO02095 cor- 
rects a problem with the AS/400 determining routes through connection net- 
works. 


MF0O2095 is not part of CUM PTF package TC91025. 
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OS/2 5250 WSF Must Have a PLU Defined in Communications Manager 


An oddity that is not discussed in the AS/400 configuration scenarios has to do 
with the OS/2 5250 WSF session profile. One of the parameters in the 5250 WSF 
profile is the APPC partner LU alias. The APPC partner LU alias (as specified in 
the 5250 WSF session profile) must match the DEFINE_PARTNER_LU 
PARTNER_LU_ALIAS verb in the .NDF file. This should make sense because it is 
in the .NDF file that Networking Services/2 finds out how to map the 
PARTNER_LU_ALIAS into the FQ_.PARTNER_LU_NAME. 


So, taking the scenario from section 11.3, “NS/2 Network Node Connection to 
AS/400 Network Node - with PC Support” on page 140 as an example, we have 
this relationship for the partner LU alias of AS400: 


9250 WSF Profile: 
APPC Partner LU Alias. . . . AS400 


used to 
establish session 
with remote host. 


DEFINE PARTNER LU FQ_PARTNER_LU_NAME(USIBMRA. bbb) 
PARTNER LU ALIAS(AS400)<— 


Figure 43. Mapping of PLU Alias to a Fully-Qualified LU Name 
The setup above works fine in all of the AS/400 scenarios. 


The problem arises from the fact that in order for your Communications Manager 
configuration file to properly verify, you must also have a “dummy” partner LU 
alias defined in Communications Manager’s partner logical unit profile. This 
“dummy” partner LU alias name is not used, except during the verification of the 
Communications Manager configuration file. | 


If you have migrated your configuration from a working Communications 
Manager configuration file, you should not have to worry about this, just as we 
did not have to in any of the AS/400 scenarios. | 


But, if you are not migrating, or are adding new 5250 WSF session profiles in 
Communications Manager, then you must create a new partner logical unit 
profile with a partner LU alias to match. 


So, now our mapping of the partner LU alias in the 5250 WSF profile to the fully- 
qualified LU Name is more like this: 


5250 WSF Profile: 
APPC Partner LU Alias. . . : AS400 


Partner LU Profile: ('Dummy! entry) 
Partner LU (PLU) Alias. . .: AS400 


used to 
establish session 
with remote host. 


DEFINE PARTNER LU FQ PARTNER_LU_NAME(USIBMRA. bbb) 
PARTNER LU _ALIAS(AS400) 


Figure 44. Mapping of PLU Alias to a Fully-Qualified LU Name - with Dummy’ Alias 


Furthermore, the partner LU profile is associated with the LU profile, mode 
profile and the initial session limit profile. You will still have to enter and verify 
all of the above profiles in the Communications Manager configuration file. 
Again, the values defined in these profiles are not used. | 
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You must also have duplicate definitions in the Networking Services/2 configura- 
tion file (NDF) using the DEFINE LOCAL _LU, DEFINE PARTNER_LU and 
DEFINE MODE verbs. This is because it is from these verbs that Networking 


Services/2 gets all of the information necessary to initialize itself. 


In the AS/400 to Networking Services/2 scenarios, we avoided this complexity by 
assuming we had a working Communications Manager configuration file (.CFG) 
and then migrating to the node definition file (.NDF). After the migration, you can 
make changes to the .NDF file, as long as those changes do not alter the naming 
of LUs as was established in the Communications Manager. 


141.2 Networking Services/2 End Node Token-Ring LAN-Attached to an AS/400 


Network Node 


This section will describe a very simple connection between a PS/2 running Net- 
working Services/2 as an end node (EN) and an AS/400 running APPC/APPN as 
a network node (NN). This connection will be made across a token-ring LAN. In 
addition, we will establish the AS/400 as a network node Server via a CP-to-CP 
session between the PS/2 end node and the AS/400 network node. Please refer 
to Figure 45 for a diagram of this network. 


PS /2-A AS /400 


0S /2 
NS /2 
5250 WSF 


ee Node | 


0S /400 
APPC /APPN 
PC Support 
Network Node 


Figure 45. NS/2 End Node Token-Ring LAN-Attached to AS/400 Network Node 


Most likely, the customer came into this scenario with the PS/2 running the 
APPC support provided by the Communications Manager of OS/2. This scenario 
will start with the PS/2 fully configured to communicate as a LEN node using 
5250 WSF to emulate a workstation attached to the AS/400’s PC Support. From 
this base (defined in “OS/2 LEN Support via Communications Manager to 
AS/400” on page 134), the PS/2 will install Networking Services/2 and migrate 
the Communications Manager configuration, to be a full end node in the APPN 
network (including CP-to-CP sessions with the AS/400 network node). Changes, 
of course, will have to be made on the AS/400 side too. 


This section will outline the steps necessary to perform this migration. It will 
identify areas where extra attention should be placed to ensure a smooth 
migration. And finally, it will show the configurations on both the PS/2 and the 
AS/400 for the final APPN network. 


Why would a customer want to do this migration? To see the full advantage, you 
must picture that the AS/400 is just the first network node in a large APPN 
network. The PS/2 with Networking Services/2 as an end node with CP-to-CP 
sessions with the AS/400 network node can make use of: 


1. Improved performance of the Networking Services/2’s implementation of 
APPC. | 


2. SAA’s CPI-C programming interface available with Networking Services/2. 
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3. Automatic LU lookup and registration with the AS/400 network node (no 
more partner-LU configuration for a large and dynamic network). 


4. The Management Services (MS) enhancements make it easier to work with a_ 
larger and more complex network. : 


5. As an end node, the PS/2 may make use of a Connection Network, using the 
AS/400 network node as a directory server. 


OS/2 LEN Support via Communications Manager to AS/400 
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This scenario assumes that the user has already been running with OS/2’s Com- 
munications Manager using the 5250 WSF emulation across a token-ring LAN. 
As a base of understanding, we have provided in Figure 46 on page 135 a 
matching parameter diagram. This diagram shows all of the important config- 
uration parameters on both the AS/400 and the PS/2. 


Note - Figure 46 on page 135 shows the configuration prior to the installation of 

Networking Services/2. Part of what this chapter will do is to identify which con- 

figuration parameters must change after the installation of Networking Services/2 
is complete. | 


Also note - while 5250 WSF is providing emulation support to the AS/400, PC 
Support has not been loaded on the PS/2. Please see section 11.3, “NS/2 
Network Node Connection to AS/400 Network Node - with PC Support” on 
page 140 for an example of PC Support on a DOS machine in the Networking 
Services/2 environment. 


Networking Services/2 


AS /400 OS/2 Comm. Manager 


Network Attributes: SNA Base Profile: 
LCLNETID(USIBMRA) PU Name (ddd) 


LCLCPNAME (bbb) Network Name (USIBMRA) 
LCLLOCNAME (bbb) Node ID(10020) 
NODETYPE (*NETNODE) 


LAN Profile: 

TRN Line: Adapter Address (ccc) 
LIND(L31TR) 
RSCRCNAME (LINOQ31) 
ADPTADR (aaa) APPC LU Profile: 


LU Alias (PS2LUA) 


APPC Controller: 
CTLD(PS2A) 
LINKTYPE(*TRLAN) 
APPN(*YES) 
SWTLINLST (L31TR) 
RMTNETID(USIBMRA) 
RMTCPNAME (ddd) 
ADPTADR (ccc) 
CPSSN(*NO) 
NODETYPE (*ENDNODE) 


APPC Partner LU Profile: 
PLU Alias (AS400) 
PLU Name (bbb) 
LU Alias (PS2LUA) 
Dest Addr(aaa) 
DLC Type(Token Ring) 


APPC Device: 
LCELOCNAME (DDb) <= 
RMTNETID(USTBMRA) 

APPN(*YES) 
MODE (QPCSUPP) 


Automatically Created 

Mode Description: Mode Profile: 
MODD (QPCSUPP} Mode Name (QPCSUPP) 
COS (#CONNECT) 


5250 Feature Profile: 
Session Selection: 


Created for PC Support 


APPC PLU Alias (AS400) 
APPC Mode Name (QPCSUPP) 


Where: aaa = AS/400 LAN adapter address ccc = PS/2 LAN adapter address 
bbb = AS/400 system name ddd = PS/2 system name 


Figure 46. Base Configuration Matching Parameters between AS/400 and OS/2 Communications Manager (pre- 
Networking Services/2) 
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PS/2-A: Install Networking Services/2 


The installation of Networking Services/2 went smoothly, and exactly as adver- 
tised. 


The only two key steps were: 


1. Install the APPC/APPN communication support and configuration programs. 
This is the base Networking Services/2 support. You do not need to install 
the sample programs and high-level language header files, because we will 
be using our own APPC application, namely 5250 WSF. 


2. Choose to have the Networking Services/2 install code migrate your default 
Communications Manager file into a .CF2 file that is used by Networking 
Services/2. This migration will create, as an intermediate step, an ASCIl file 
(for viewing and editing) with an extension of .NDF. It is this .NDF file that is 
shown in Figure 47 on page 137. 


Note - all of these files (CFG, .NDF, and .CF2) will have the same filename - 
that of the default Communications Manager configuration file. 


Shut down the PS/2 after the installation program has exited and all disk activity 
has completed. Re-boot. 


PS/2-A: Review of the Migrated Configuration 


After the Communications Manager configuration file (.CFG) has been migrated 
by the installation of Networking Services/2, a node definition file (NDF) was 
created. It is this viewable and editable file that we will discuss in this section. 
Please see Figure 47 on page 137. Note - numbers inside of small boxes have 
been added to the figure as an aid for references. 


After the PS/2 was re-booted, and before any changes were made to the Net- 
working Services/2 or AS/400 configurations, Communications Manager was 
restarted and a 5250 WSF session was established to the AS/400. This was suc- 
cessful because Networking Services/2 migrated the PS/2 LEN node to be an end 
node without CP-to-CP sessions. In Figure 47, (1) shows that the 

DEFINE LOCAL CP is an end node and (4) defines that this end node does not 
have CP_CP_SESSION_SUPPORT with a network node. 


Another good reason why the Networking Services/2 migration did not define 
CP-to-CP sessions, is that there was no way for it to know the CP name of the 
network node server. Look at (2a and 2b). The CP_NAME is CPQ00002, which 
Networking Services/2 generates without knowing what the real CP_NAME will 
be. These will be some of the places we must edit to establish CP-to-CP ses- 
sions with the AS/400 network node. 
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Node Definition File (.NDF) 


DEFINE _LOCAL_CP FQ_CP_NAME(USIBMRA. ddd 


) 


DESCRIPTION(Created by the migration utility on 02-12-91 at 04:11p) 


CP_ALIAS(PS2LUA ) 


NODE_TYPE(EN) 
NODE_ID({X'10020') 
HOST_FP_SUPPORT (NO) ; 


1 


DEFINE LOGICAL_LINK LINK _NAME(LINKQ001) 


DLC_NAME (IBMTRNET) 
ADAPTER_NUMBER(@) 


CP_CP_SESSION_SUPPORT(N 
ACTIVATE_AT_STARTUP(NO) 


DESCRIPTION(Created by the migration utility on 82-12-91) 
leeeena Q ADJACENT _CP_NAME(USI 
ADJACENT _NODE_TYPE(LEN) 


NAU_ADDRESS (INDEPENDENT LU) 


BMRA. CP900002 ) A 
a 


DESTINATION ADDRESS (aaa) 


0) 

LIMITED_RESOURCE (USE_ADAPTER_DEFINITION) 
LINK _STATION_ROLE(USE_ADAPTER_DEFINITION) 
SOLICIT_SSCP_SESSION(NO) 
EFFECTIVE_CAPACITY(USE_ADAPTER DEFINITION) 
COST_PER_CONNECT_TIME(USE_ADAPTER DEFINITION) 
COST_PER_BYTE(USE_ADAPTER DEFINITION) 
SECURITY (USE_ADAPTER_DEFINITION) 

PROPAGATION DELAY(USE_ADAPTER_DEFINITION) 
USER_DEFINED_1(USE_ADAPTER_DEFINITION) 

USER DEFINED 2(USE_ADAPTER_DEFINITION) 
USER_DEFINED_3(USE ADAPTER DEFINITION) ; 


DEFINE PARTNER LU FQ_PARTNER LU _NAME(USIBMRA.bbb ) 


DESCRIPTION(Created by the migration utility on 62-12-91) 


PARTNER_LU_ALIAS(AS400) 
MAX _MC_LL_SEND_SIZE(32767) 
CONV_SECURITY_ VERIFICATION (NO) 
PARALLEL_SESSION SUPPORT (YES) ; 


DEFINE_PARTNER_LU LOCATION FQ PARTNER_LU_NAME(USIBMRA.bbb ) 
DESCRIPTION(Created by the migration utility on 92-12-91) 


WILDCARD ENTRY (NO) 
|z»| ——————+Fo_own1n@_ch_nane (ust ura. cPooa0e2 ) 
LOCAL_NODE_NN_SERVER(YES); 


DEFINE MODE MODE _NAME(QPCSUPP ) 


DESCRIPTION(Created by the migration utility on 02-12-91 at 04:11p) 


COS_NAME (#CONNECT) 
DEFAULT_RU_SIZE(NOQ) 


MAX_RU_SIZE_UPPER_BOUND (1920) 


RECEIVE PACING WINDOW(8) 


MAX_NEGOTIABLE SESSION LIMIT (32767) 


PLU MODE_SESSION_LIMIT(8) 
MIN CONWINNERS SOURCE (A); 


DEFINE DEFAULTS IMPLICIT_INBOUND_PLU_SUPPORT(YES) 
DESCRIPTION(Created by the migration utility on 02-12-91 at 04:11p) 
DEFAULT _MODE_NAME (BLANK) 
DEFAULT LOCAL _LU_ALIAS(PS2LUA ) 
MAX MC_LL_SEND SIZE(32767) 
DIRECTORY FOR_INBOUND ATTACHES(*) 
DEFAULT _TP_OPERATION(NONQUEUED_AM_ STARTED) 
DEFAULT TP PROGRAM TYPE(BACKGROUND) 
DEFAULT_TP_CONV SECURITY RQD(NO) 


MAX_HELD_ALERTS(10); 


CNOS LOCAL_LU_ALIAS(PS2LUA ) 
FQ PARTNER LU _NAME(USIBMRA.bbb ) 
MODE_NAME(QPCSUPP ) 
SET_NEGOTIABLE(NO) 
PLU_MODE_SESSION_LIMIT(8) 
MIN _CONWINNERS SOURCE (4) 
MIN CONWINNERS TARGET(4) 
AUTO_ACTIVATE(®) ; 


Where: aaa 
bbb 


AS/400 LAN adapter address 
AS/4600 system name 


Figure 47. Node Definitions File (.NDF) after Installation and Migration 


ccc 
ddd 


PS/2 LAN adapter address 
PS/2 system name 


_| | 
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PS/2-A: Edit the .NDF File 


You must edit the node definition file (.NDF) to define CP-to-CP sessions with the 
AS/400 network node. Follow these steps while referring to the numbers in 
Figure 47 on page 137: 3 


1. Start an edit session of the .NDF file. 
. At (2a), change the CP_NAME from CPO000002 to bbb (AS/400 CP name). 


. At (4), change the ACTIVATE_AT_STARTUP from NO to YES. 


_ At (6), delete the entire DEFINE PARTNER_LU_ LOCATION definition for the 
network node server. 


6. Save the changes to the .NDF file. 


2 

3. At (3), change the ADJACENT NODE_TYPE from LEN to NN. 
4 
5 


When you are done, the .NDF file should look like Figure 48 on page 139. 


PS/2-A: Verify the Configuration 


Use the Verify Configuration option of Networking Services/2. This will take the 
.NDF file as input, and create a new .CF2 configuration file which Networking 
Services/2 will use to communicate with the AS/400 network node. 


AS/400: Configuration Changes 


The configuration changes on the AS/400 are simple. Since the AS/400 was 
already a network node, and since it already had an APPC connection defined to 
PS/2-A, all that has to be done is upgrade this connection to include CP-to-CP 
sessions. This is done on the AS/400 by: 


1. VRYCFG CFGOBJ(PS2A) CFGTYPE(*CTL) STATUS(*OFF) 
2. CHGCTLAPPC CTLD(PS2A) CPSSN(*YES) 
3. VRYCFG CFGOBJ(PS2A) CFGTYPE(*CTL) STATUS(*ON). 


The important step above is number 2. It is this step that enables the AS/400 
side of the CP-to-CP session to the PS/2 end node. 


For the final mapping between the AS/400 network node and PS/2 end node con- 
figuration parameters, please see Figure 48 on page 139 (a parameter mapping 
diagram). 
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Node Definition File (.NDF) 


DEFINE LOCAL_CP FQ CP_NAME(USIBMRA.ddd ) 


DEFINE LOGICAL_LINK LINK_NAME(LINKOO1) 


DEFINE PARTNER_LU FQ _PARTNER_LU_NAME(USIBMRA.bbb ) 


DEFINE MODE. MODE _NAME(QPCSUPP ) 


DESCRIPTION(Created by the migration utility on 02-12-91) 
CP_ALIAS(PS2LUA  ) 

NAU_ADDRESS(INDEPENDENT_LU) 

NODE_TYPE(EN) 

NODE_ID(X'10020') 

HOST_FP_SUPPORT (NO) ; 


DESCRIPTION(Created by the migration utility) 
FQ_ADJACENT_CP_NAME(USIBMRA. bbb) 

ADJACENT _NODE_TYPE(NN) 

DLC_NAME (IBMTRNET) 

ADAPTER_NUMBER(Q) 

DESTINATION ADDRESS (aaa) 
CP_CP_SESSION_SUPPORT (YES) 
ACTIVATE_AT_STARTUP(YES) 

LIMITED RESOURCE (USE_ADAPTER_DEFINITION) 
LINK STATION ROLE(USE_ADAPTER_DEFINITION) 
SOLICIT_ SSCP ~ SESSION(NO) 

EFFECTIVE _CAPACITY (USE_ ADAPTER_DEFINITION) 
COST_PER_ CONNECT _TIME(USE_ ADAPTER DEFINITION) 
COST_ PER BYTE (USE__ ADAPTER DEFINITION) 
SECURITY (USE_ ADAPTER DEFINITION) 

PROPAGATION _DELAY(USE_ ADAPTER_DEFINITION) 
USER_ DEFINED. 1(USE_ADAPTER _DEFINITION) 

USER_ DEFINED | 2(USE_ ADAPTER DEFINITION) 

USER DEFINED 3(USE ADAPTER DEFINITION); 


DESCRIPTION(Created by the migration utility) 
PARTNER_LU_ALIAS(AS409) 
MAX_MC_LL_SEND_$IZE(32767) 
CONV_SECURITY_VERIFICATION(NO) 
PARALLEL_SESSION_SUPPORT(YES) ; 


DESCRIPTION(Created by the migration utility on 62-12-91) 
COS SIEM CONIC <r 
DEFAULT _RU_SIZE(NO) 

MAX _RU_SIZE_UPPER_BOUND(1920) 
RECEIVE PACING WINDOW(8) 
MAX_NEGOTIABLE_SESSION_LIMIT(32767) 
PLU_MODE_SESSION_LIMIT(8) 
MIN_CONWINNERS SOURCE (4); 


DEFINE DEFAULTS IMPLICIT_INBOUND_PLU_SUPPORT(YES) 


DESCRIPTION(Created by the migration utility on 02-12-91) 
DEFAULT MODE_NAME (BLANK) 

DEFAULT _LOCAL_LU_ALIAS(PS2LUA  ) 

MAX MC_LL_SEND_SIZE (32767) 

DIRECTORY FOR_INBOUND_ATTACHES(*) 

DEFAULT _TP_OPERATION(NONQUEUED AM STARTED) 

DEFAULT _TP_PROGRAM_TYPE (BACKGROUND) 

DEFAULT TP _CONV_SECURITY_RQD(NO) 

MAX_HELD_ALERTS(18) ; 


CNOS LOCAL LU _ALIAS(PS2LUA ) 

FQ PARTNER LU_NAME(USIBMRA.bbb ) 
MODE_NAME(QPCSUPP ) 

SET NEGOTIABLE (NO) 
PLU_MODE_SESSION LIMIT(8) 

MIN CONWINNERS SOURCE (4) 

MIN CONWINNERS TARGET (4) 
AUTO_ACTIVATE (0) ; 


Where: 
bbb 


and 


aaa 


AS/400 LAN adapter address ccc = PS/2 LAN adapter address 
AS/400 system name ddd = PS/2 system name 
on the left margin, indicates this item was changed. 


' 


Mode Description: 


AS /400 


Network Attributes: 
LCLNETID(USIBMRA) 


LCLCPNAME (bbb) 
LCLLOCNAME (bbb) 
NODETYPE (*NETNODE) 


TRN Line: 


LIND(L31TR) 
RSCRCNAME (LINO31) 


APPC Controller: 


CTLD(PS2A) 
LINKTYPE(*TRLAN) 
APPN(*YES) 
SWTLINLST(L31TR) 
RMTNETID (USI BMRA) 
RMTCPNAME (ddd) 
ADPTADR(ccc) 
CPSSN(*YES) 
NODETYPE (*ENDNODE) 


APPC Device: 


LCLLOCNAME (bbb) 
RMTNETID(USIBMRA) 
APPN(*YES) 

MODE (QPCSUPP) 


Automatically Created 


Created for PC Support 


Figure 48. Final PS/2 .NDF and AS/400 Object Configuration Parameter Mapping 
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41.3 NS/2 Network Node Connection to AS/400 Network Node - with PC 


Support 


This scenario will describe a much more complex network involving Networking 
Services/2 on the PS/2 and APPC/APPN on the AS/400. Depicted in Figure 49 is 
a common wide area network (WAN) problem. At one site, the customer has a 
token-ring LAN of PS/2s. At another remote site (possibly central to other PS/2 
LANs) is the company’s AS/400. 


PS/2-A AS /400 
SDLC 
Leased 


0S /400 

APPC /APPN 

PC Support 
Network Node 


Network Node 


DOS 


PC Support 
LEN Node 


Figure 49. NS/2 NN Connection to AS/400 NN - with PC Support 


In the past, this WAN problem was solved by LAN bridges. The problem with 
token-ring LAN bridges is that they are expensive, needing dedicated PS/2s on 
either end of the WANs to tie them together. 


With Networking Services/2, one of the PS/2s on the token-ring LAN may be con- 
figured to be a network node, allowing it to route intermediate node session data 
from any LEN node or end node PS/2 to the remote AS/400 (and beyond, if the 
network grows to have more sites). 


Other advantages of this network configuration: 


1. PS/2s configured as end nodes in the LAN can receive routing directions 
directly from the local PS/2 network node, thereby avoiding costly traffic 
across the SDLC line each time a new local connection needs to be estab- 
lished. 


2. Applications, such as PC Support, may easily connect to the remote AS/400, 
as well as any other AS/400 in the APPN network. 


3. The PS/2 configured as the network node on the LAN may be used like any 
other PS/2 (PC Support, customer applications, etc.) and does not have to be 
dedicated to supporting the SDLC connection to the AS/400. 


4. The LAN of PS/2s (PS/2s A, B and C) are protected from changes in the 
APPN network by directing all LU searches through the PS/2-A network 
node. That is, if changes are made to any location or availability of a remote 
LU, the PS/2-A network node will Know of this change and act accordingly. 
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In this scenario, the first thing we will configure is the network node to network 
node relationship between PS/2-A and the AS/400. This connection will be over 
a leased SDLC line. : 


Next, we will include PS/2-B, the end node on the same token-ring LAN as the 
PS/2-A network node. PS/2-B will use PS/2-A as an intermediate node to estab- 
lish a 5250 WSF session with the remote AS/400. 


The final step will be to configure PS/2-C, which is running DOS 4.01 with the 
DOS version of PC Support. It too (like PS/2-B) will be using the PS/2-A NN as 
an intermediate node, routing session data through to the remote AS/400. 


AS/400 and PS/2-A Network Node Final Configuration Parameter Mapping 


Physical Connection between AS/400 and PS/2-A 
The AS/400 and PS/2-A network nodes are connected by a single SDLC leased 
line. 


For the AS/400, this SDLC leased line will be the only logical (and of course 
physical) link to PS/2-A and the rest of the PS/2s (B and C) on the token-ring 
LAN. The definition of this link is found in the SDLC line description 
LIND{SDLCLIN2). Many of the parameters found in SDLCLIN2 have a direct 
relationship with ones in the Communication Manager’s DLC profile on PS/2-A. 
Please refer to Figure 50 on page 143 for a diagram of these relationships. 


The ROLE is set to be *NEG (negotiable) on both the AS/400’s LIND and CTLD as 
well as the link station role on PS/2-A. This allows the AS/400 and the PS/2-A to 
negotiate their link role to be either primary or secondary. In this setting it 
really does not matter which host is primary or secondary, and specifying *NEG 
allows the greatest flexibility. 


The exchange identifier (EXCHID on the AS/400 and NODE_ID on the PS/2-A) 
need only be unique in the network. 


CNN(*NONSWTPP), NRZI(*YES), MAXOUT(4) and DUPLEX{*FULL) need to be con- 
figured to match their associated parameters in the PS/2-A SDLC DLC profile. 


Logical Link Definition between AS/400 and PS/2-A 

The AS/400 uses the controller description to define each logical link to an adja- 
cent link node. In this scenario, the AS/400 has only one adjacent link node 
(PS/2-A) and therefore, only one controller description: CTLD{SDLCCTL2). It is 
through SDLCCTL2 that all session data will flow across the logical link to PS/2-A 
(and beyond). 


PS/2-A uses DEFINE LOGICAL LINK LINK _NAME(LINKO001) to define its logical 
link (via the SDLC line) to the remote AS/400 network node. 


As sessions are established with remote LU partners (located on PS/2-A, PS/2-B 
and PS/2-C) the AS/400 will automatically create device descriptions: one for 
each remote LU. In this scenario, the AS/400 will create three DEVDs, all 
attached to CTLD{SDLCCTL2). The parameter RMTLOCNAME (found in the 
DEVD) will be automatically set to dddA, dddB, and dddC reflecting the remote 
LU names on systems PS/2-A, PS/2-B and PS/2-C, respectively. These three 

- device descriptions will be attached to CTLD(SDLCCTL2) because they all use 
that logical link. 
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Pictorially, the relationship between the AS/400 communication objects will look 
like this if you use WRKCFGSTS *LIN SDLCLIN2 (knowing that the AS/400 will 
automatically create the device descriptions based upon the remote location 
name they represent): 


SDLCLIN2 /*SDLC Line Description*/ 
SDLCCTL2 /*APPC Controller Description*/ 
dddA /*APPC Device Description for RATLOCNAME(dddA)*/ 
dddB /*APPC Device Description for RMUTLOCNAME(dddB)*/ 
dddC /*APPC Device Description for RMTLOCNAME(dddC)*/ 


5250 WSF Considerations between PS/2-A and the AS/400 

The parameter mapping diagram found in Figure 50 on page 143 is complete to 
the point where one could establish sessions between the PS/2-A network node 
and the AS/400. The only thing missing from the diagram is the extra work 
involved configuring the 5250 WSF support. 


For the AS/400, the system administrator must create a user profile and add a 
directory user to the system. This is done via the CRTUSRPRF and ADDDIRE 
commands on the AS/400. 


On PS/2-A, you must ensure that the 5250 feature profile is configured with a 
session selection of: 


e APPC PLU Alias...AS400 
e APPC Mode Name...QPCSUPP 


and you must start the 5250 WSF session while in Communications Manager. 


PS/2-A Additional Logical Link Definitions 

The network node PS/2-A has two additional logical links defined to the two 
other PS/2s on the token-ring LAN. Each of these logical links uses the 
IBMTRNET ADAPTER_NUMBER(0) for the physical connection to the adjacent 
nodes. This IBM TRN adapter must have been previously defined in the Commu- 
nications Manager LAN adapter profile. 


LINK0002 to PS/2-B: LINKOOO2 defines the logical link to PS/2-B, which is a PS/2 
running: 


e OS/2 
e Networking Services/2 as an end node (with CP-to-CP sessions) 
¢ Communications Manager’s 5250 WSF. 


The DESTINATION ADDRESS(cccB) is the TRN address of PS/2-B. 


The parameter CP_CP_ SESSION SUPPORT(YES) indicates that this logical link 
will establish a control point session with the remote link station. 


LINK0003 to PS/2-C: LINKOOO3 defines the logical link to PS/2-C, which is a PS/2 
running: | 


e DOS 
e PC Support as a low entry networking (LEN) node. 


The DESTINATION _ADDRESS(cccC) is the TRN address of PS/2-C. 


The parameter CP_CP_SESSION_SUPPORT(NO) indicates that this logical link 
will not establish a control point session with the remote link station. 


Networking Services/2 


PS/2-A network node configuration 


PS/2-A SDLC DLC Adapter Profile (CM): 
Adapter number (0) 
Load DLC(Yes) 
Free unused link{No) 


Maximum RU size(512) 
Send window count(4) 
Receive window count(4) 


Line type(non-switched) 
Link station role(Negotiable) 
Local station address(01) 


Line mode(Constant request to send) 
NRZI (Yes) 


PS/2-A node definition file (.NDF) 


DEFINE_LOCAL_CP FQ CP_NAME(USIBMRA.dddA) 

DESCRIPTION(PS/2-A Network Attributes) 

CP_ALIAS(PS2LUA  ) 

NAU_ADDRESS( INDEPENDENT LU) 

NODE_TYPE(NN) 

NODE_ID(X'10020') 

HOST_FP_SUPPORT (NO) ; 
DEFINE_LOGICAL_LINK LINK _NAME(LINKO001) 
DESCRIPTION(Logical link to AS/400) 
ADJACENT_NODE_TYPE(NN) 
PREFERRED NN SERVER(NO) 
DLC_NAME(SDLC +) 
ADAPTER_NUMBER(0) 

CP_CP_SESSION SUPPORT (YES) 
ACTIVATE_AT_STARTUP(YES) ; 

DEFINE LOGICAL _LINK LINK_NAME(LINKOQ02) 
DESCRIPTION(logical link to PS/2-B EN) 
ADJACENT_NODE_TYPE (LEARN) 

DLC_NAME (IBMTRNET) 

ADAPTER_NUMBER(9) 

DESTINATION _ADDRESS(cccB) 
CP_CP_SESSION SUPPORT (YES) 
ACTIVATE_AT_STARTUP(YES) ; 

DEFINE LOGICAL LINK LINK_NAME(LINKOOO3) 

DESCRIPTION(logical link to PS/2-C LEN) 
FQ ADJACENT_CP_NAME(USIBMRA. dddC) 
ADJACENT _NODE_TYPE(LEN) 
DLC_NAME (I BMTRNET) 
ADAPTER_NUMBER(6) 
DESTINATION ADDRESS(cccC) 
CP_CP_SESSION SUPPORT (NO) 
ACTIVATE_AT_STARTUP(NO) ; 


DEFINE PARTNER LU FQ_PARTNER_LU_NAME(USIBMRA.bbb ) 
DESCRIPTION(Define the Partner LU on the AS/400) 
PARTNER_LU_ALIAS(AS400) 

MAX _MC_LL_SEND_SIZE(32767) 
CONV_SECURITY_VERIFICATION(NO) 
PARALLEL SESSION SUPPORT (YES) ; 


DEFINE MODE MODE_NAME (QPCSUPP ) 
DESCRIPTION(The PC Support mode) 
COS_NAME (#CONNECT) 
DEFAULT RU_SIZE(NO) 
MAX_RU_SIZE_UPPER_BOUND(1920) 
RECEIVE PACING WINDOW(8) 
MAX NEGOTIABLE _SESSION_LIMIT (32767) 
PLU_MODE_SESSION_LIMIT(8) 
MIN _CONWINNERS SOURCE (4) ; 


START_ATTACH_ MANAGER; 


Where: N/A 
bbb 


AS/400 LAN adapter addr 
AS/400 system name 


cccB 
dddB 


PS/2-A LAN adapter addr 
PS/2-A system name 


cccA 
dddA 


Figure 50. AS/400 and PS/2-A NN Final Configuration Parameter Mapping 


PS/2-B LAN adapter addr 
PS/2-B system name 


AS /400 


SDLC Line: 
LIND(SDLCLIN2) 
RSCRCNAME (LINO61) 
ROLE (*NEG) 
INTERFACE (*RS232V 24) 
CNN (*NONSWTPP) 
EXCHID( 05600001) 
NRZI (*YES) 
MAXFRAME (521) 


Network Attributes: 
LCLNETID(USI BMRA) 
LCLCPNAME (bbb) 
LCLLOCNAME (bbb) 
NODETYPE (*NETNODE) 


APPC Controller: 
CTLD(SDLCCTL2) 
LINKTYPE(*SDLC) 
APPN(*YES) 
LIND(SDLCLIN2) 
RMTNETID(USI BMRA) 
RMT CPNAME (dddA) 
SWITCHED (*NO) 
CPSSN(*YES) 
NODETYPE (*NETNODE) 
ROLE (*NEG) 
MAXFRAME (521) 
STNADR(01) 


APPC Device(s): 
The AS/400 will auto- 
matically create three 
devices, one for each 
remote LU as they 
first attempt to 
connect. They will 
all be attached to the 
CTLD(SDLCCTL2), since 
they use that logical 

link to PS/2-A as the 

first hop. 


Mode Description: 
MODD(QPCSUPP) 
COS (#CONNECT) 


Created for PC Support 


cecCc 
dddC 


PS/2-C LAN adapter addr 
PS/2-C system name 
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PS/2-B Final Configuration (OS/2 End Node) 
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Logical Link Definition between PS/2-B and PS/2-A 

PS/2-B is configured to be an end node running with CP-to-CP sessions to its 
network node server PS/2-A. The DEFINE LOGICAL_LINK LINK _NAME(LINKO0001) 
on PS/2-B is used to carry all of the session traffic to PS/2-A. 


5250 WSF Considerations between PS/2-B and the AS/400 

The .NDF file found in Figure 51 on page 145 is complete to the point where one 
could establish sessions between the PS/2-B end node and the AS/400. The only 
thing missing from the diagram is the extra work involved in configuring 5250 
WSF support. 


For the AS/400, the system administrator must create a user profile and add a 
directory user to the system. This is done via the CRTUSRPRF and ADDDIRE 
commands on the AS/400. 


On PS/2-B, you must ensure that there is a 5250 feature profile configured with a 
session selection of: 


e APPC PLU Alias...AS400 
e APPC Mode Name...QPCSUPP 


and you must start the 5250 WSF session while in Communications Manager. 


Please note - when PS/2-B attempts to establish the session to the AS/400, it 
uses its CP-to-CP session to the PS/2-A network node to locate the remote LU 
bbb (the AS/400). This is why you do not have to have any additional verbs in 
the .NDF file for PS/2-B to describe the location of the remote LU bbb. In fact, 
the AS/400 machine could be moved to another location in the WAN and the 
.NDF file for PS/2-B would not have to change, because PS/2-A would know of 
the move due to its role as a network node. 
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PS/2-B node definition file (.NDF) 


DEFINE_LOCAL_CP FQ_CP_NAME(USIBMRA.dddB ) 


DESCRIPTION(PS/2-B Network Attributes) 
CP_ALIAS(PS2LUB ) 

NAU_ADDRESS( INDEPENDENT LU) 

NODE_TYPE (EN) 

NODE_ID(X'10014') 

HOST _FP_ SUPPORT (NO) ; 


DEFINE LOGICAL_LINK LINK _NAME(LINKO0@1) 


DESCRIPTION(Logical Link to PS/2-A NN) 
FQ_ADJACENT CP_NAME(USIBMRA.dddA ) 
ADJACENT NODE_TYPE(NN) 

DLC_NAME (IBMTRNET) 

ADAPTER_NUMBER(0) 

DESTINATION _ADDRESS(cccA) 
CP_CP_SESSION_SUPPORT(YES) 
ACTIVATE_AT_STARTUP(YES) ; 


DEFINE PARTNER LU FQ _PARTNER_LU_NAME(USIBMRA.bbb ) 


DESCRIPTION(Define Partner LU to the remote AS/400) 
PARTNER_LU | ALIAS (AS400) 

MAX _MC_ LL SEND _S1ZE(32767) 

CONV_ SECURITY _VERIFICATION (NO) 

PARALLEL SESSION _ SUPPORT (YES) ; 


DEFINE MODE MODE_NAME(QPCSUPP ) 
DESCRIPTION(The PC Support Mode) 
COS_NAME(#CONNECT) 
DEFAULT _RU_SIZE(NO) 
MAX _RU_ SIZE_ UPPER_BOUND(1928) 
RECEIVE PACING _ WINDOW (8) 
MAX _ NEGOTIABLE SESSION_LIMIT(32767) 
PLU | MODE_ SESSION _LIMIT(8) 
MIN CONWINNERS _ SOURCE (4) ; 


DEFINE_DEFAULTS 


Where: N/A 


IMPLICIT_INBOUND PLU_SUPPORT (YES) 

DESCRIPTION(Created by the migration utility on 02-14-91) 
DEFAULT_MODE_NAME (BLANK) 

DEFAULT_LOCAL_LU_ALIAS(PS2LUB  ) 

MAX _MC_ Wee SEND _SIZE(32767) 

DIRECTORY_ FOR_ TNBOUND _ ATTACHES (*) 

DEFAULT _TP _OPERATI ON(NONQUEUED_ AM | STARTED) 

DEFAULT_ TP. PROGRAM | TYPE (BACKGROUND) 

DEFAULT TP _CONV_SECURITY_RQD(NO) 


= AS/400 LAN adapter addr cccA = 
bbb = AS/400 system name dddA = PS/2-A system name dddB 


MAX HELD ALERTS(10) ; 


PS/2-A LAN adapter addr  cccB = PS/2-B LAN adapter addr cccC = PS/2-C LAN adapter addr 


PS/2-B system name dddC = PS/2-C system name 


Figure 51. PS/2-B EN Final Network Definition File 


PS/2-C Final Configuration (DOS) CONFIG.PCS File 


The configuration for the DOS version of PC Support for PS/2-C is fairly straight 
forward. This section will not cover all of the steps to do this, it will only cover 
the areas which may be confusing and/or problematic. 


PS/2-C will behave much like PS/2-B, in that both will be using PS/2-A as a 
network node server (for directory services) and as an intermediate node for 
sessions to the AS/400. So, the configuration for PS/2-A must do some of the 
same things, namely, identify PS/2-A as the network node and request that a 
session be established with the remote LU bbb (the AS/400). 


Final CONFIG.PCS File for PS/2-C | 

In figure Figure 52 on page 146 below is the final CONFIG.PCS (PC Support con- 
figuration file) for PS/2-C. It is this file which defines the physical TRN addresses 
and the names of LUs that will be used to establish sessions with the AS/400 
through PS/2-A. For each four letter identifier in the file we have provided a 
description: 
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SFLR 1,1, QIWSFLR, bbb 
RTLN USIBMRA. dddC 
TRLI dddA,cccA 

ADRS bbb,dddA 


RTYP ITRN 
Where: N/A 
bbb 


AS/400 LAN adapter addr cccA = PS/2-A LAN adapter addr cecC 
AS/400 system name dddA = PS/2-A system name dddC 


identifier Description 


SFLR This identifier starts a shared folder session with system bbb 
(which is the remote AS/400). | 
RTLN This identifier defines the fully-qualified CP name for PS/2-C. No 


configuration is necessary on the AS/400 to map to this name. This 
is because PS/2-A will dynamically inform the AS/400 of its exist- 
ence. | 


TRLI This identifier defines the logical link to the PS/2-A network node 


server: cccA is PS/2-A’s LAN adapter address, and dddA is 
PS/2-A’s CP name. All requests to bind a session with a remote LU 
will first be sent to this node. 


ADRS This identifier is used to attach our local PS/2-C through an inter- 
mediate system (PS/2-A) to the AS/400. The first parameter (bbb) 
is the system name of the AS/400. The second parameter (dddA) is 
the PS/2-A system name. 


Note - since we are using names in the ADRS identifier, the actual 
location of these machines could change, but this configuration file 
need not, because APPN will dynamically update the PS/2-A 
network node with the proper information. 


RTYP This identifier merely identifies that a TRN LAN router will be used. 


PS/2-C LAN adapter addr 
PS/2-C system name 


Figure 52. PS/2-C LEN (DOS) CONFIG.PCS File 


5250 Session Manager Profile 

One of the problems with the above configuration for PS/2-C is that the 5250 
session manager will use remote system name dddA (which is the PS/2-A) as 
the default when attempting to establish a session. The correct remote system 
name should be bbb (the AS/400). This happens because system dddA (the 
PS/2-A) is defined to be the remote system for the logical link in the TRLI state- 
ment. 


The solution to this problem is to change the 5250 WSF session profile so that it 
does not use the default, but rather, uses bbb (the AS/400 system name). 


To do this you must use the CFGWSF command to change or create a session 
profile. The important parameter to define in the session profile is the General 
session Option: 


System name. . 2... 2 ee eee bbb 


Make sure you save the session and master profiles to disk, and that the 
STARTPCS.BAT file has been updated to look for the new session and master 
profiles. 
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Please see the AS/400 PC Support : OS/2 Operations Reference (SC21-8198) for 
more information on how to create or change session and master profiles for the 
5250 session support. 


11.4 NS/2 Network Node Connection to AS/400 Network Node - via Subarea 


Network 


This scenario is similar to the one in section 11.3, “NS/2 Network Node Con- 
nection to AS/400 Network Node - with PC Support” on page 140. The difference 
is that instead of a direct SDLC connection between the LAN of PS/2s and the 
AS/400, we have put in its place a subarea network. All session traffic between 
the PS/2s and the AS/400 will be routed through the subarea. 


In addition to the LU-to-LU traffic being routed through the subarea, the final step 
in this configuration will configure the AS/400 as an alert focal point (FP) for all 
of the PS/2s. This alert data will be routed (just like the other session traffic) 
through the subarea network. The AS/400 will also be configured to forward all 
alerts to the S/370 host NetView product. 


Please refer to Figure 53 for a diagram of this network. 


S/370 
NetView 
VTAM 
NCP 
Subarea 
Token Token 
Ring Ring 
PS/2-B PS/2-A AS /400 
0S/2 0S/2- 0S /400 
NS /2 NS /2 APPC /APPN 
5250 WSF 5250 WSF PC Support 
End Node Network Node Network Node 


PS /2-C 


DOS 


PC Support 
LEN Node 


Figure 53. NS/2 NN Connection to AS/400 NN - via Sub-Area Network 


This scenario will: 
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1. Show the special configuration needed to connect two network nodes (one 
PS/2 and the other AS/400) across a subarea network. 


2. Demonstrate the ease in which changes can be made to an APPN network 
by showing that the configurations of both PS/2-B and PS/2-C do not change 
from Figure 49 on page 140 and Figure 53 on page 147. 


3. Demonstrate alert processing in a distributed network. This will make use of 
Networking Services/2 Management Service’s ability to collect local alerts 
and forward then onto a focal point. It will also make use of the AS/400’s 
ability to collect those alerts across a subarea network and forward them to 
NetView. | 


PS/2-A Final Configuration, with Logical_Link to Subarea 


PS/2-A does not have to change much to move from the example in section 11.3, 
“NS/2 Network Node Connection to AS/400 Network Node - with PC Support” on 
page 140 to the one here, which includes a subarea network between it and the 
remote AS/400. Only two things have to change in PS/2-A’s .NDF file. One is 
the DEFINE LOGICAL LINK verb, and the other is the addition of a | 

DEFINE PARTNER_LU LOCATION verb to define the path to all of the remote 
LUs. 


The DEFINE LOGICAL_LINK verb has to change because now PS/2-A has to 
route all of its session data through the subarea network on the way to the 
AS/400. To define this link to an adjacent node Networking Services/2 uses the 
DEFINE LOGICAL LINK verb. 


Please refer to Figure 54 on page 149 for the final .NDF file of PS/2-A. Note - 
numbers inside of small boxes have been added to the figure as an aid for refer- 
ences in the discussion below: 


1. The LINK_NAME(LINKO0001) was kept the same as the previous scenario. It 
should be made clear, however, that this logical link definition is to the adja- 
cent subarea node, not the AS/400. 


2. The FQ ADJACENT CP NAME(USIBMRA. yyy) is the fully-qualified SSCP 
name of the host system. The syntax of the fully-qualified CP name is 
(<network ID>.<CP name>). Please note that the fully-qualified CP name 
used here is the same one that has all of the unknown remote LUs routed to 
it based upon the DEFINE PARTNER_LU LOCATION verb mentioned in (6). 


3. The adjacent node is of type LEN. This is because the host system does not 
support CP-to-CP sessions. And it is because of this lack of CP-to-CP ses- 
sions that forces PS/2-A (and the AS/400 as you will see later) to define the 
path to all of the remote LUs (see (6) below). In effect, PS/2-A views the 
subarea LEN node to be the location of the remote LUs. 


4. The DESTINATION. ADDRESS(xxx) is the token-ring LAN adapter address of 
the subarea node. 


5. As was stated above, there are no CP-to-CP sessions between PS/2-A and 
the host system. This is a limitation of the host. 


6. The DEFINE PARTNER_LU_ LOCATION verb is used to define the path to 
remote LUs that cannot automatically be discovered via APPN. Because 
there are no CP-to-CP sessions with the host system, our PS/2-A network 
node cannot find the remote LU named bbb (the AS/400 system name). 


This verb (used as a WILDCARD) tells Networking Services/2 to route all 
unknown LU searches to the fully-qualified system USIBMRA.yyy, which is 
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the host computer with its subarea network. PS/2-A will assume that the LU 
is located either at that node, or that the subarea network will route data to 
the AS/400. 


PS/2-A Node Definition File (.NDF) 


DEFINE LOCAL_CP FQ _CP_NAME(USIBMRA.dddA ) 
DESCRIPTION(PS/2 Network Attributes) 
CP_ALIAS(PS2LUA ) 
NAU_ADDRESS( INDEPENDENT LU) 
NODE_TYPE (NN) 
NODE_ID(X'16020'); 


| DEFINE LOGICAL_LINK LINK_ NAME (L1NK@901) ——————__—,] 

| DESCRIPTION(logical link to VTAM subarea) 

| FQ_ADJACENT_CP NAME (USIBMRA. yyy 17] 
| ADJACENT_ NODE _TYPE(LEN) 

{ PREFERRED_ NN _SERVER(NO) 3| 

| DLC_NAME (IBMTRNET) 

{ ADAPTER_NUMBER(6) 4] 

| DESTINATION ADDRESS (xxx) 

| CP_CP_SESSIOH_SUPPORT (No) 
| ACTIVATE_AT_STARTUP(YES) ; 


DEFINE LOGICAL_LINK LINK_NAME(LINKOQ02) 
DESCRIPTION(logical link definition to PS/2-B EN) 
ADJACENT NODE _TYPE(LEARN) 
DLC _NAME (I BMTRNET) 
ADAPTER_NUMBER(8) 
DESTINATION _ADDRESS (cccB) 
CP_CP_ SESSION |_ SUPPORT (YES) 
ACTIVATE _AT _STARTUP(YES) ; 


DEFINE LOGICAL_LINK LINK _NAME(LINKOQ03) 
DESCRIPTION(logical link definition for PS/2-C LEN) 
FQ ADJACENT CP_NAME(USIBMRA. dddC) 
ADJACENT _NODE_TYPE(LEN) 
DLC_NAME (1 BMTRNET) 
ADAPTER_NUMBER(0) 
DESTINATION _ADDRESS(ceecl) 
CP_CP_ SESSION _ SUPPORT (NO) 
ACTIVATE_ AT _STARTUP(NO) ; 


DEFINE_PARTNER_LU FQ _PARTNER_LU_NAME(USIBMRA.bbb ) 
DESCRIPTION(Created by the migration utility) 
PARTNER_LU_ALTAS(AS400) 
MAX_MC_LL_SEND_SIZE(32767) 

CONV_SECURITY VERIFICATION(NO) 
PARALLEL SESSION SUPPORT(YES) ; 


| DEFINE_PARTNER_LU_LOCATION WILDCARO_ENTRY (FULL) »=———[6] 
| FQ_OWNING_CP_NAME (USIBMRA. yyy) 


| LOCAL_NODE_NN SERVER(YES) ; 


DEFINE_MODE MODE_NAME({QPCSUPP ) 
DESCRIPTION(Created by the migration utility) 
COS_NAME(#CONNECT) 
DEFAULT RU_SIZE(NO) 
MAX_RU_SIZE_UPPER _BOUND( 1924) 
RECEIVE_ PACING | WINDOW(8) 
MAX_ NEGOTIABLE SESSION LIMIT (32767) 
PLU_MODE_SESSION_LIMIT(8) 
MIN CONWINNERS SOURCE (4) ; 


DEFINE DEFAULTS IMPLICIT_INBOUND PLU_SUPPORT(YES) 
DESCRIPTION(Created by the migration utility) 
DEFAULT MODE_NAME (BLANK) 
DEFAULT LOCAL LU ALIAS(PS2LUA ) 
MAX_MC_ LL_ SEND | SIZE (32767) 
DIRECTORY_FOR_INBOUND ATTACHES (*) 
DEFAULT_TP_OPERATION(NONQUEUVED_AM | STARTED) 
DEFAULT “TP '_PROGRAM | TYPE (BACKGROUND) 
DEFAULT _ TP_ CONV_ SECURITY _RQD(NO) 
MAX_HELD_ALERTS(10) ; 


START_ATTACH_ MANAGER; 


Where: xxx = VTAM LAN adapter addr cccA = PS/2-A LAN adapter addr  cccB = PS/2-B LAN adapter addr  cccC = PS$/2-C LAN adapter addr 
yyy = VTAM system name dddA = PS/2-A system name dddB = PS/2-B system name dddC = PS/2-C system name 
and : | = on the left margin, indicates this item was changed from Figure 50 on page 143. 


Figure 54. PS/2-A NN Final Network Definition File, with Logical_Link to Subarea 
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PS/2-B Final Configuration - No Changes 


The final configuration for PS/2-B does not change from the previous scenario 
(see section 11.3, “NS/2 Network Node Connection to AS/400 Network Node - 
with PC Support” on page 140). This is due to the fact that PS/2-B was config- 
ured to rely on PS/2-A’s network node abilities to provide directory support, 
route selection, and perform as an intermediate node to the sessions between 
PS/2-B and the AS/400. This demonstrates the adaptability of an APPN network. 


For a description of the network definition file (NDF) for PS/2-B please see 
Figure 51 on page 145. 


PS/2-C Final Configuration - No Changes 


The final configuration for PS/2-C also did not change from the previous sce- 
nario. Please see “PS/2-B Final Configuration - No Changes.” for the reasons 
why. 


For a description of the CONFIG.SYS file for PS/2-C please see Figure 52 on 
page 146. 


VTAM Final Configuration 
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The host computer in this scenario must define the locations of all the remote 
LUs. In this example, this is done with two switched major node definition files. 


One is for the AS/400. The switched major node definition file for the AS/400 can 
be found in Figure 55 on page 151. 


The other is for the remote LUs reached through PS/2-A. Since PS/2-A is a 
network node (that can do intermediate routing), the VTAM definition file simply 
thinks that all of the LUs dddA, dddB, and dddC are located at the adjacent node. 
It is PS/2-A that takes care of routing data destined for a particular LU to the 
proper system. Please take a look at the switched major node definition file for 
PS/2-A Figure 56 on page 151. 


When you have VTAM V3R4 installed, definitions for the session originator will 
be created dynamically. Therefore, for 5250 WSF you would not need to define 
the LUs in the workstations, but only the LU in the AS/400. 
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RAEKKKKKEREREKERKEEREREKKEKKEERKEKKKEKRRRERERKRERKKRERERKEKRERRERERREKRKRRERERKERER 


* 


* AS/400 IN A TOKEN-RING NETWORK 


* 


* 
* 
* 


KKEKEKKKREKKEKKREKRKRERREKRKERKREEKREREKRKEEKRRREKERKKRREKEKREKRERRRREREKEKRERERERER 


SWAS400B VBUILD MAXGRP=5, REQUIRED X900010480 
MAXNO=12, REQUIRED X00010490 
TYPE=SWNET REQUIRED 00010500 

KK 

Rowen eee PU AND LU'S DEFINITION FOR AS/400 SYSTEM 9404---- 

Kk 

T13P9404 PU ADDR=01, COULD BE ANYTHING (NOT USED) X90010540 
MAXDATA=265, AS/400 SYSTEM X00010550 
CPNAME=bbb, AS/400 CP NAME X00010550 
DISCNT=NO, X00010570 
MAXOUT=7, X00010580 
MAXPATH=2, X00010590 
PACING=(7,1), X00010610 
VPACING=8, X00010610 
PUTYPE=2, X00010620 
PASSLIM=7, x 
ISTATUS=ACTIVE 

me 00010640 

TRI3A40A PATH DIALNO=0004aaa, TO AS/400 9404 (SMALL) X90010830 
GRPNM=EG13L01, FROM TIC 2 X00010840 
GID=1, X00010850 
PID=2, X00010860 
USE=YES INITIALY ACTIVE 

Kk 

Keene -- == Define AS/400 LUs---------------------------------- 

bbb LU LOCADDR=0, MODETAB=MTGS3X, DLOGMOD=QPCSUPP, ISTATUS=ACTIVE 

* 

Where: aaa = AS/400 LAN adapter addr  cccA = PS/2-A LAN adapter addr cccB = PS/2-B LAN adapter addr  cccC = PS/2-C LAN adapter addr 

bbb = AS/400 system name dddA = PS/2-A system name dddB = PS/2-B system name dddC = PS/2-C system name 

Figure 55. VTAM Switched Major Node Definition File for the AS/400 

KEKKKKKKEKKERERERKEKKRAERRRKKKRKERERKRKKEKRKRREKKEKRREREKKRKRRERKERERKRRREEKERERK 

* * 

* PS/2 NN IN A TOKEN-RING NETWORK WITH BACKBONE SNA * 

* * 

KKEKKKKKREKREKREKKEKREREEKKEKKKEKREKKEKRRKEKRKEKEKRKKEKREREKREREREREKRRRERKRKRKRRERER 

SWASPS2 VBUILD MAXGRP=5, REQUIRED X90010480 
MAXNO=12, REQUIRED X00010490 
TYPE=SWNET REQUIRED 00010500 

xk 

Kaen enn =~ PU AND LU'S DEFINITION FOR PS/2-A NN SYSTEM ---- 

KK 

SWASPS2A PU ADDR=01, COULD BE ANYTHING (NOT USED) X00010540 
MAXDATA=265, PS/2-A SYSTEM X60010550 
CPNAME=dddA, PS/2-A ID BLOCK NUMBER X60019550 
DISCNT=NO, X00010570 
MAXOUT=7, X00010580 
MAXPATHE=2, X00010590 
PACING=(7,1), X00010610 
VPACING=8, X00010610 
PUTYPE=2, X00010620 
PASSLIM=7, X 
ISTATUS=ACTIVE 

ae 90010649 

SWAPS2P PATH DIALNO=0004cccA, TO PS/2 NN X00010830 
GRPNM=EG13L01, FROM TIC 2 X00010840 
GID=1, X00010850 
PID=2, X00010860 
USE=YES INITIALLY ACTIVE 

** 

dddA LU LOCADDR=0,MODETAB=MTGS3X, DLOGMOD=QPCSUPP, ISTATUS=ACTIVE 

dddB LU LOCADDR=0,MODETAB=MTGS3X, DLOGMOD=QPCSUPP, ISTATUS=ACTIVE 

dddC LU = =LOCADDR=0,MODETAB=MTGS3X, DLOGMOD=QPCSUPP, ISTATUS=ACTIVE 

* 

Kk 

Where: aaa = AS/40Q LAN adapter addr  cccA = PS/2-A LAN adapter addr cccB = PS/2-B LAN adapter addr  cccC = PS/2-C LAN adapter addr 

bbb = AS/400 system name dddA = PS/2-A system name dddB = PS/2-B system name dddC = PS/2-C system name 


Figure 56. VTAM Switched Major Node Definition File for PS/2-A 


Chapter 11. AS/400 Considerations 


151 


AS/400 Final Configuration | 


In Figure 59 on page 154 you will see the final AS/400 configuration objects nec- 
essary to participate as a network node in this scenario. One of the things that 
has changed in this scenario is the AS/400’s host controller description. 


Another is that if any program must originate a session from the AS/400 to one 
of the remote PS/2s, we must define how to get to those remote locations via the 
AS/400’s APPN remote location lists. 


AS/400 Controller Description 

The AS/400 controller description is the AS/400’s definition of an adjacent link 
station. In this case, the adjacent link station is the host system. In this APPN 
network, the AS/400 views the subarea as a LEN node, because there are no 
CP-to-CP sessions between them. 


Please see Figure 59 on page 154 for a description of the AS/400 controller 
description and all the other relevant AS/400 configuration objects. 


APPN Remote Location Lists 

Because the AS/400 does not have CP-to-CP sessions with any other system, 
there is no way for the AS/400 to search the network to determine where remote 
LUs are located. Very much like the DEFINE PARTNER_LU_ LOCATION that had 
to be added in PS/2-A’s .NDF file, so must we add APPN remote location lists to 
the AS/400 for the remote LUs found in our LAN of PS/2s (dddA, dddB, and 
dddC). 


If you have never created an APPN configuration list, you must use the CRTCFGL 
command: 


CRICFGL TYPE(*APPNRMT) TEXT('Remote configuration list for PS/2-A, PS/2-B, and PS/2-C') 
APPNRMTE((dddA USIBMRA bbb yyy USIBMRA) 


Where: aaa 


bbb 
XXX 
YY 


AS/400 LAN adapter addr cccA 


(dddB USIBMRA bbb yyy USIBMRA) 
(dddC USIBMRA bbb yyy USIBMRA)) 


PS/2-A LAN adapter addr 


AS/400 system name dddA = PS/2-A system name 
VTAM LAN adapter addr cccB = PS/2-B LAN adapter addr 
VTAM system name dddB = PS/2-B system name 
cccC = PS/2-C LAN adapter addr 
dddC = PS/2-C system name 


Figure 5/7. Create Configuration List CL Example 
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The steps outlined above will give you the following remote configuration list 
(QAPPNRMT): 


Networking Services/2 


Display APPN Remote Locations 


Configuration list > QAPPNRMT 


Remote Remote Control Control 

Location Network Location Point Point Secure 
Name ID Name Name Net ID Loc 
dddA USIBMRA bbb yyy USIBMRA *NO 
dddB USIBMRA bbb yyy USIBMRA *NO 
dddC USIBMRA bbb yyy USIBMRA *NO 


Bottom 
Press Enter to continue. 


F3=Exit Fil=Additional information  F12=Cancel 


Figure 58. DSPCFGL CFGL(QAPPNRMT) - Display Configuration List for QAPPNRMT 


Automatic Creation of APPC Device Descriptions 

The AS/400 will still automatically create the APPC device descriptions for the 
three remote PS/2s (PS/2-A, PS/2-B and PS/2-C). This will occur the first time 
the remote PS/2s attempt to connect to the AS/400. 


AS/400 Final Configuration Objects 
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Network Attributes: 
LCLNETID(USIBMRA) 
LCLCPNAME (bbb) 
LCLLOCNAME (bbb) 
NODETYPE(*NETNODE) 


TRN Line: 

LIND (L31TR) 

RSCRCNAME (LINO31) 

ADPTADR (aaa) Host Controller: 

EXCHID (05615533) CTLD(L31CTLTR) 
LINKTYPE(*TRLAN) 
APPN(*YES) 
SWTLINLST(L31TR) 
RMTNETID (USTBMRA) 
RMTCPNAME (yyy) 
CPSSN(*NO) 
NODETYPE(*LENNODE) 
SSCPID (050000000014) 
ADPTADR (xxx) 


APPC Device(s): 
The AS/400 will auto- 
matically create three 


devices, one for each 
remote LU as they 
first attempt to 
connect. They will 
all be attached to the||Created for PC Support 
CTLD(L31CTLTR), since 
they use that logical 


Mode Description: 
MODD (QPCSUPP) 


COS (#CONNECT) 


link to the Host as 
the first hop. 


Where: aaa = AS/400 LAN adapter addr xxx = VTAM LAN adapter addr 
bbb = AS/400 system name yyy = VIAM system name 


Figure 59. AS/400 Final Configuration to the Host VTAM Subarea 


Alert Processing on PS/2, AS/400 and NetView 


The last thing we are going to do in our APPN network is to establish an alert 
processing design which includes the entire PS/2 LAN, the AS/400, and the host 
system. 


In general, all alerts generated from the LAN of PS/2s will be forwarded to the 
AS/400 on the other side of the subarea network. This will allow the AS/400 
operator to filter the alerts, before they are sent up to the host system and 
NetView. 


By having a somewhat complex arrangement for the flow of alerts we demon- 
strate how alerts from Networking Services/2 can be directed through a subarea 
network (or any APPN network that can route LU sessions) to a remote system 
(like the AS/400) that can act as an alert focal point. 


Alert Processing on the PS/2 LAN 

Since PS/2-B and PS/2-C both use PS/2-A to do intermediate node routing on the 
way to the AS/400, we will use PS/2-A’s network management to send an alert to 
the AS/400. Failures in either PS/2-B or PS/2-A will be seen in PS/2-A and 
should be reported to the AS/400 administrator. 
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Because of our simplistic view of the PS/2 LAN (all sessions are routed through 
PS/2-A), all we have to do to receive alerts from PS/2-A is to define in the 
AS/400 that our sphere of control (SOC) includes PS/2-A. This discussion is left 
to the next section. 


Alert Processing in the AS/400 

The AS/400 is in the center of this alert processing design. Because of this, we 
must do two things to enable the alert management desired. The first is to 
enable the AS/400 to generate and forward alerts up to the host system; and the 
second is to define the AS/400’s sphere of control (SOC) to include PS/2-A. 


Enable Alert Processing on the AS/400: To enable alert processing on the 
AS/400 one must make changes to the network attributes. Look to Figure 60 for 
an example of the CL command to make these changes. 


The most important parameter on the CHGNETA command is 
ALRCTLD(L31CTLTR). This parameter indicates that all alerts that the AS/400 
receives will be forwarded to the host system via controller description 
L31CTLTR on the CP-SSCP flow. 


Note - Networking Services/2 also has the ability to forward alerts to the host 
system via a CP-SSCP flow for end nodes in its domain when it is boundary- 
attached to the subarea. We do not show this in this scenario, however. 


CHGNETA ALRSTS(*ON) ALRPRIFP(*YES) ALRDFTFP(*NO) ALRLOGSYS(*ALL) 
ALRCTLD(L31CTLTR} ALRHLDCNT (0) 


Lae ee eevee en eee eee ee ee 


Figure 60. Change Network Aitributes Command on the AS/400 to Enable Alerts 


Define the AS/400 SOC: We must define the AS/400 SOC to include PS/2-A. 
This is because we need the AS/400 to send an MS Capabilities message to 
PS/2-A. The MS Capabilities message will tell the PS/2 that the AS/400 is its 
focal point for alerts. This is done via the WRKSOC command on the AS/400. 


The MS Capabilities message is sent to a remote LU name. This is one of the 
reasons we had to define PS/2-A’s remote LU name in the AS/400 APPN remote 
location list. 


Please note - the sending of the MS Capabilities message is not automatic. The 
system administrator must define the remote location to be in the SOC of the 
AS/400 to send the MS Capabilities. For this to be successful, the remote 
location must be up and running. So, before you continue with this section, 
please ensure that PS/2-A is up and running in order to receive and respond to 
the MS Capabilities message. 


Also note - if the remote system defined in the AS/400’s SOC is taken down, and 
then back up again, it is the responsibility of the system operator to delete and 
recreate the SOC for that remote system, via the WRKSOC command. 


Add PS/2-A’s CP Name to the AS/400’s SOC via WRKSOC Command: The fol- 
lowing screens show the steps necessary to add PS/2-A to the SOC of the 
AS/400. It is when the “Current Status” of the SOC entry becomes "Add 
pending” that the AS/400 will send the MS Capabilities message to the remote 
PS/2. Please see Figure 64 on page 15/7. 
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Command Entry bbb 
Request level: 5 
Previous commands and messages: 


(No previous commands or messages) 


Bottom 
Type command, press Enter. 
===> wrksoc 


F3=Exit F4=Prompt F9=Retrieve F10=Include detailed messages 
Fll=Display full Fl2=Cancel Fl3=User support F16=System main menu 


Figure 61. WRKSOC - Work with Sphere of Control 


Work with Sphere of Control (SOC) 
bbb 
Position to Control Point 
Network ID 


Type options, press Enter. 
4=Remove 


Control 
Opt Point Network ID Current Status 


(No entries in sphere of control) 


Bottom 
F3=Exit F5=Refresh F6=Add entries F9=Display SOC status 
Fll=Display new focal points  F12=Cancel 


Figure 62. Add PS/2-A’s LU Location to the AS/400 SOC (Add Entry) 
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Add Sphere of Control Entries 


System: 
Type Network ID and Control] point names to add, press Enter. 


Control 

Point Network ID 

dddA USIBMRA 
*NETATR 
*NETATR 
*NETATR 
*NETATR 
*NETATR 
*NETATR 
*NETATR 
*NETATR 
*NETATR 
*NETATR 
*NETATR 
*NETATR 
*NETATR 
*NETATR 


F3=Exit F5=Refresh  F12=Cancel 


Figure 63. Add PS/2-A’s CP Name dddA and Network ID USIBMRA to SOC (Enter) 


Work with Sphere of Control (SOC) 
| System: bbb 
Position to Control Point 
Network ID 


Type options, press Enter. 


4=Remove 


Control 
Opt Point Network ID Current Status 
dddA USTBMRA Add pending 


Bottom 


F3=Exit F5=Refresh F6=Add entries F9=Display SOC status 
Fll=Display new focal points  F12=Cancel 
1 entries added to sphere of control. @ entries not added. 


Figure 64. USIBMRA.dddA Has Been Added to AS/400 SOC - Add Pending MS Capabilities 
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Incorrect Current Status of Inactive - Session Down: After the AS/400 has prop- 
erly added the remote PS/2-A to its SOC we typed an F5=Refresh. To our sur- 
prise, the “Current Status” for our new USIBMRA.dddA SOC entry went to 
“Inactive - session down”, even though we confirmed that the AS/400 was prop- 
erly receiving and forwarding all alerts from PS/2-A. 


The reason for this misleading “Current Status” is due to the fact that the adja- 
cent link station, through which this alert session is being routed, does not have 
any CP-to-CP sessions. The connection to the host system only has an 
SSCP-to-CP session. And it is due to this lack of CP-to-CP sessions that the 
AS/400 thinks the alert session is down. 


We have included this screen (Figure 65) to warn you of the misleading “Current 
Status” of “Inactive - session down’. 


Work with Sphere of Control (SOC) 
System: 
Position to Control Point 
Network ID 


Type options, press Enter. 


4=Remove 


Control 
Opt Point Network ID Current Status 
dddA USTBMRA Inactive - session down 


Bottom 


F3=Exit F5=Refresh F6=Add entries F9=Display SOC status 
Fll=Display new focal points F12=Cancel 


Figure 65. Inactive - Session Down: Due to Lack of CP-to-CP Session with Host System 
Deleting a SOC Entry: To delete a SOC entry, simply enter a 4 in the “Opt” 


column and press Enter. This will terminate the AS/400’s SOC over the remote 
PS/2, and allow you to create a SOC entry later. 
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Work with Sphere of Control (SOC) 


System: 
Position to Control Point 
Network ID 


Type options, press Enter. 
4=Remove 


Control 
Opt Point Network ID Current Status 
4 dddA USIBMRA 


Bottom 
F3=Exit F5=Refresh F6=Add entries F9=Display SOC status 
Fll=Display new focal points  F12=Cancel 


Figure 66. Remove the SOC Entry 


Confirm Remove of Sphere of Control Entries 
System: 
Press Enter to confirm your choices for 4=Remove. 
Press F1l2 to return to change your choices. 


Control 
Opt Point Network ID Current Status 
4 dddA USTBMRA 


Bottom 


Fll=Display new focal points  F12=Cancel 


Figure 67. Removing SOC Entry Confirmation 
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Alert Processing in the Host System 

The host system is the final focal point for all alerts in our network. For informa- 
tion on the NetView definitions necessary for managing an APPN network see 
Management of AS/400 in SNA Subarea Network using NetView Products. 
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Chapter 12. Performance Study 


12.1 Introduction 


This chapter is provided as an aid in understanding how APPC transaction pro- 
grams (TPs) perform in the new Networking Services/2 environment relative to 
the previously announced APPC support included under OS/2 EE 1.2 Communi- 
cations Manager. 


Representative benchmark TPs are used to measure performance. By utilizing 
these benchmark results, you can estimate performance improvements in your 
application. 


12.2 Methodology 


Over the years, a series of APPC performance benchmarks evolved that provide 
a standard method to measure the performance of various APPC implementa- 
tions. Further, these benchmarks provide a method by which we can compare 
the performance of different releases of the same APPC implementations. By 
measuring the performance of these typical application TPs, we can accurately 
gauge Networking Services/2 performance improvements from an end-user per- 
spective. 


The following APPC performance benchmarks were used in the study: 
e Credit check transaction 
e Inquiry transaction 
e Database update transaction 
e Pipeline transaction 


e File transfer transaction. 


See “Benchmark Descriptions” on page 173 for details concerning these 
benchmarks. 


A sizable number of TPs were written for the OS/2 EE 1.1 Communications 
Manager and OS/2 EE 1.2 Communications Manager APPC APis. Many of these 
TPs will be migrated to execute under Networking Services/2. Consequently, 
APPC performance benchmark TPs written for the OS/2 EE 1.1 Communications 
Manager and OS/2 EE 1.2 Communications Manager APPC APis were executed 
on both OS/2 EE 1.2 Communications Manager and Networking Services/2 in 
order to measure performance improvements in the underlying Networking 
services/2 software. 


In addition, many newly written transaction programs will likely utilize Net- 
working Services/2’s CPI-C interface. CPI-C APPC performance benchmarks 
were measured to understand how the additional Networking Services/2 CPI-C 
software layer (on top of APPC) impacts application TP performance. However, 
we cannot directly compare the CPI-C benchmark results with the previously 
described benchmarks executed on the Networking Services/2 APPC implemen- 
tation because of an important operational restriction for CPI-C: each CPI-C con- 
versation is uniquely associated with an OS/2 process. In order to avoid timing 
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the overhead of starting and terminating an OS/2 process with each benchmark 
iteration, each CPI-C benchmark TP was coded as a long running transaction. In 
other words, CPI-C benchmark timings do not include the overhead of allocating 
and de-allocating each conversation. In order to gauge the impact of the CPI-C 
benchmark performance results, OS/2 EE 1.2 Communications Manager long 


running performance benchmark TPs were executed. The difference in perform- 


ance between the CPI-C and OS/2 EE 1.2 Communications Manager long running 
benchmarks will provide the CPI-C software layer degradation. The OS/2 EE 1.2 
Communications Manager long running performance benchmark TPs are simply 
referred to as the “long” benchmark TPs in the rest of this chapter; whereby the 
long running CPI-C benchmark TPs are simply referred to as the “CPI-C” 
benchmark TPs. 


Finally, Networking Services/2 introduced the network node (NN) variable into 
the performance equation. Network nodes provide the capability to route ses- 
sions through themselves without being a session end-point. This capability is 
known as intermediate session routing (ISR). The APPC performance 
benchmarks were executed on a two node Networking Services/2 configuration, 
and then retested after introducing a Networking Services/2 intermediate 
network node into the configuration. The degradation between the two node and 
three node performance results indicates the delay introduced by a Networking 
Services/2 NN providing ISR. 
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12.3 Benchmark Performance Results 


This section provides the raw performance data gathered from executing the 
APPC performance benchmarks. Results are broken down into two sets of data 
for comparison purposes: 


e OS/2 EE 1.1 Communications Manager and OS/2 EE 1.2 Communications 
Manager APPC performance benchmarks: This data allows us to calculate 
the performance gains for TPs migrated from OS/2 EE 1.1 Communications 
Manager to OS/2 EE 1.2 Communications Manager to Networking Services/2. 


e Long and CPI-C APPC performance benchmarks: This data allows us to 
analyze the performance impact of the Networking Services/2 CPI-C software 
layer. 


OS/2 EE 1.1 Communications Manager and OS/2 EE 1.2 Communications 
Manager APPC Benchmark Performance Results 
The various OS/2 EE 1.1 Communications Manager and OS/2 EE 1.2 Communi- 
cations Manager performance benchmark TPs are listed down the left column of 
each table. The row of data to the right of each benchmark indicates its per- 
formance executing on different APPC implementations and node configurations. 


The first two columns of data to the right of each benchmark indicate perform- 
ance results from the base OS/2 EE 1.2 Communications Manager APPC imple- 
mentation. The next two columns of data give performance results for each 
benchmark executed on OS/2 EE 1.2 Communications Manager with Networking 
Services/2 installed. The final two columns of data provide the benchmark per- 
formance results from execution on a three node Networking Services/2 config- 
uration. 


A pair of performance results are provided for each execution of each 
benchmark TP: | 
1. Average number of the times the benchmark TP executed per second 
2. Average duration of each benchmark TP 


see “Measurement Configuration” on page 171 for details concerning the test 
configurations. 
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Table 2. 4Mbps APPC Benchmark Performance Results _ | | | 


Benchmark TP Base 1.2 NSI2 NS/2 


2 Node Config 2 Node Config 3 Node Config 
| TPs/Sec Secs TPs/Sec Secs TPs/Sec Secs 
1.1 Credit Check 0.0579 65 0.0152 47 0.0209 
14 Inqury | 0.0632, 56 0.0178 42 0.0235 
1.1 Update 1 0.0923 35 0.0284 24 0.0402 


0 
1.1 File Xfer (100K) 4 0.5562 4 0.2330 3 0.3200 
1 


1.2 Update 0.0860 40 0.0244 27 0.0367 
1.2 Pipeline 0.0153 138 0.0072 136 0.0073 
1.2 File Xfer (16K) 0.1053 19 0.0520 13 0.0742 
1.2 File Xfer (100K) 0.5247 #4 0.2330 3 0.3300 


Table 3. 16Mbps APPC Benchmark Performance Results 


Benchmark TP Base 1.2 NS/2 NS/2 


2 Node Config 2 Node Config 3 Node Config 


1.1 File Xfer (16K) ) 
1.1 File Xfer (100K) 


0.1043 22 0.0442 14 0.0671 
1 0.5247 #246 0.1590 3 0.2570 


1.2CreditCheck 0.0562 73 0.0136 52 0.0191 
1.2 Inquiry 0.0590 68 0.0146 50 0.0200 


1.2 Update 0.0860 42 0.0238 28 0.0346 
1.2 Pipeline _ 0.0153 138 0.0072 136 0.0073 
1.2 File Xfer (16K) 0.0994 23 0.0431 15 0.0666 
1.2 File Xfer (100K) | 0.4950 6 0.1590 3 0.2570 
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Long and CPI-C APPC Benchmark Performance Results 


The various long and CPI-C performance benchmark TPs are listed down the left 
column of each table. The row of data to the right of each benchmark indicates 
its performance executing on different node configurations. 


The first two columns of data to the right of each benchmark indicate results for 
each benchmark executed on a two node Networking Services/2 configuration. 
The final two columns of data provide the benchmark performance results from 
execution on a three node Networking Services/2 configuration. 


A pair of performance results are provided for each execution of each 
benchmark TP: 


1. Average number of the times the benchmark TP executed per second 
2. Average duration of each benchmark TP. 


see “Measurement Configuration” on page 171 for details concerning the test 
configurations. 
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Table 4. 4Mbps APPC Benchmark Performance Results 
Benchmark TP NS/2 | NS/2 


2 Node Config 3 Node Config 

TPs/Sec Secs TPs/Sec Secs 
Long Credit Check 107 0.0093 ) 0.0156 
Long Inquiry — 0.0107 0.0167 
Long Update 0.0200 0.0321 
Long Pipeline 0.0028 0.0028 
Long File Xfer (16K) 0.0493 0.0729 
Long File Xfer (100K) | 0.2330 0.3250 
CPI-C Credit Check 0.0098 | 0.0156 


| 102 64 
19 13 


CPI-C File Xfer (16K) 0.0501 0.0734 
CPI-C File Xfer (100K) 4 0.2330 3 0.3310 


Table 5. 16Mbps APPC Benchmark Performance Results 


Benchmark TP NS/2 NS/2 


2 Node Config 3 Node Config 
TPs/Sec Secs TPs/Sec Secs 


28 16 ; 
6 3 ; 
105 65 


Long File Xfer (16K) 0.0353 0.0615 
Long File Xfer (100K) 0.1550 0.2600 


0.0152 


CPI-C Credit Check 0.0095 
CPI-C Inquiry 0.0119 58 0.0172 
CPI-C Update 0.0217 0.0329 
CPI-C Pipeline 0.0027 0.0028 
CPI-C File Xfer (16K) 0.0355 0.0614 
CPI-C File Xfer (100K) 0.1600 0.2580 
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12.4 Conclusions and Observations 


There are five major components that effect overall benchmark TP performance. 
These five are: 


e Main system processor 

e Disk sub-system (controller, disk driver, and device drivers) 
e Token-ring adapter cards (and device drivers) 

e APPC communication software 


e Benchmark TPs. 


The key to understanding performance is to determine when one of these com- 
ponents is acting as a bottleneck for a given benchmark. It is important to 
understand that the bottleneck may change with differing benchmark TPs. 
Improving performance of only one component will not necessarily improve 
overall performance. This is especially true if the component being improved is 
not a limiting factor for a particular benchmark. 


Before analyzing benchmark results, we need to recognize that the main system 
processor, disk sub-system, and token-ring adapter cards are constants in our 
performance equation. The token-ring device drivers, APPC software, and 
benchmark TPs are the variables. 


Knowing the variable components, we can draw a number of conclusions from 
the benchmark TP results: 


* The limiting component in the base OS/2 EE 1.2 Communications Manager 
APPC implementation was the APPC software. While varying the token-ring 
speed from 4 to 16Mbps, we achieved virtually no benchmark TP perform- 
ance improvement even with throughput oriented benchmarks like file 
transfer, thereby eliminating the token-ring component as a bottleneck candi- 
date. The benchmark TPs themselves can be eliminated because we know 
from Networking Services/2 benchmark tests that these TPs are capable of 
executing much quicker. This leaves APPC as our bottleneck. 


Further, TPs written to take advantage of the combined indicator and com- 
bined verb capabilities of OS/2 EE 1.2 Communications Manager gain little 
(roughly 0-10%) over those TPs written for OS/2 EE 1.1 Communications 
Manager when executed on the base OS/2 EE 1.2 Communications Manager. 


e Networking Services/2 claims a times two (x2) performance improvement 
over OS/2 EE 1.2 Communications Manager when executing in a LAN-only 
environment. In reality, Networking Services/2 achieves roughly a x2 to x11 
performance improvement. 


However, for the non-file transfer benchmarks executed on the Networking 
services/2 APPC implementation, virtually no performance improvements 
are noted when varying the LAN speed from 4 to 16Mbps for the 
benchmarks. This could indicate that either the benchmark TPs or the APPC 
software are the performance bottleneck for the non-file transfer benchmarks 
on the Networking Services/2 APPC implementation, or that the major con- 
tributing factor in the performance was the latency or delay of the Token- 
Ring components. This latency changes little between 4Mbps and 16Mbps 
Token-Ring components. 


Conversely, the file transfer benchmarks executed on the 4Mbps LAN are 
partially bandwidth delimited in performance. When executed on the 16Mbps 
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LAN, these benchmarks provide a significant jump in performance. In partic- 
ular, the 100KB file transfer benchmark executes in excess of 5Mbps on the 
16Mbps LAN. 


e As expected, the impact of an intermediate NN on performance is dependent 
on the line flows of the benchmark. For example, the Pipeline benchmark 
merely sends one packet of data from the client to the server without waiting 
for an acknowledgement. Consequently, the introduction of an intermediate 
NN has little effect on performance (under 5%). 


However, benchmarks that alternate line flows (Credit Check, Inquiry, and 
Update) suffer a greater performance degradation (roughly 20-40%). This 
degradation is attributable to the client having to wait for the intermediate 
NN to forward client requests to the server, and in turn, forward replies back 
to the client. 


While the file transfer benchmarks do not alternate line flows at the 
APl-level, these benchmarks do require LAN-level acknowledgements of data 
receipt at the server. In addition, the file transfer benchmarks place a greater 
demand on the movement of data between the adapter and main memory. 
Consequently, file transfer performance is degraded even further on the 
16Mbps LAN (roughly 30-45%). Because the 4Mbps LAN itself is the limiting 
factor for the file transfer benchmarks, performance is degraded less 
(roughly 25-35%). 


It should be noted that the only configuration parameters that made any sig- 
nificant difference in performance when going from a two node to a three 
‘node configuration were the Receive Window Count and Send Window Count 
parameters that are both specified in the IBM token-ring Network DLC 
Adapter Profile. These counts should never be set below 4 in order to 
achieve optimal results. See “IBM Token-Ring Network DLC Adapter Profile” 
on page 281 for details on this profile. 


e The overhead in using the CPI-C API rather than the APPC API is under 15%. 
Short transactions in a two node configuration provide the most significant 
delays. When adding an intermediate NN to the configuration the overhead 
drops below 10%. This drop is attributable to the overall lengthening of the 
transaction time while keeping the CPI-C overhead constant. 


When transferring large amounts of data in any configuration, the CPI-C 
overhead drops below 5%. Again, this is attributable to the relatively small 
CPI-C overhead when compared to the overall duration of the transaction. 


e After benchmark performance results were recorded, the same series of 
APPC performance benchmarks were re-run on each configuration in order 
to monitor CPU utilization. The table below reflects these observations: 


Table 6. Workstation CPU Utilizations 


[Node ——SSS~*d ase SCNWAN 


This chart indicates that Networking Services/2 is consuming a significantly 
smaller slice of the available CPU cycles while at the same time achieving 
greater throughput. In other words, significantly more processing power is 
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left for the application TPs under Networking Services/2 than under base 
OS/2 EE 1.2 Communications Manager. 


e While testing the base OS/2 EE 1.2 Communications Manager APPC imple- 
mentation and the two node Networking Services/2 APPC implementation, 
these observations were made: 


The performance of all test TPs except the file transfer benchmark was 
not significantly impacted by any changes to the Networking Services/2 
configuration (.NDF file) or the underlying Communications Manager con- 
figuration (.CFG file). This is due to the relatively small amount of data 
being exchanged by these benchmark TPs. Consequently, you should 
feel confident that these performance results will directly apply to your 
application regardless of the configuration specifics. 


The performance of the file transfer benchmarks are significantly affected 
by the specifics of the underlying Communications Manager configuration 
file (CFG). Again, this is due to the relatively large amount of data being 
exchanged by these benchmark TPs. 


The following configurable parameters play a significant role: 


Transmit buffer size This parameter should never be set less than 1KB. 
Note that at 1KB and above, Networking Services/2 surpasses 
NetBIOS performance on large data transfers. 


Number of transmit buffers Performance is greatly boosted when this 
parameter is set to 2. 


Receive buffer size This parameter should be set as small as possible. 
No significant performance reduction was noted due to the 
chaining of receive buffers by LAN device driver software. 


Maximum RU size No significant performance improvements were noted 
when this parameter was set above 2KB for 4Mbps LAN 
testing, or above 4KB for 16Mbps LAN testing that used the 
IBM token-ring 16/4 Adapter/A. 


Send window count This parameter should never be set less than 4. Set- 
tings above 4 show no significant performance improvements 
on traversing a bridge-less LAN. In general, overall perform- 
ance improves when you maximize the window count when 
traversing LAN bridges. Conversely, when traversing WAN 
bridges (such as T1 links), the WAN bridge tends to congest 
when given large incoming frames with large receive 
windows. Weight these factors when determining your DLC 
window sizes. 


Receive window count Always set this parameter equal to the Send 
window count. 


All of these parameters are part of the token-ring adapter configuration 
under Communications Manager. See “IEEE 802.2 Token-Ring Profile” on 
page 279 and “IBM Token-Ring Network DLC Adapter Profile” on 

page 281 for details concerning the Communications Manager profiles. 


By default, no Networking Services/2 configurable parameter played a 
significant role in the performance of the file transfer benchmarks. In par- 
ticular, the mode-level RU size and the session pacing windows are 
dynamically adapted to optimal settings when allowed to default. 
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However, the size of the data buffers used by the benchmarks TPs did 
significantly impact performance. The smaller the data buffers associated 
with the SEND_DATA or RECEIVE_AND_WAIT verbs, the more numerous 
the crossings of the APPC API. Design your application such that the 
data buffers are at least as large as the underlying RU sizes (2KB for the 
4Mbps LAN, 4KB for the 16Mbps LAN). 


Also, refer to the /BM SAA Networking Services/2 APPC Programming 
Reference for additional Networking Services/2 tuning recommendations. 


12.5 Benchmark Performance Details 


Measurement Configuration 


This section details the configurations used for executing the APPC performance 
benchmarks. 


Node Topology 
The base OS/2 EE 1.2 Communications Manager and Networking Services/2 
(NN-NN) benchmarks were run on the following configuration: 


4/16Mbps T/R 


Figure 68. Two Node Benchmark Configuration 


The Networking Services/2 (NN-NN-NN) benchmarks were run on the following 
configuration: 


4/16Mbps T/R #1 


Figure 69. Three Node Benchmark Configuration 


Other Configuration Factors 
A number of other performance factors were closely regulated in order to mini- 
mize the performance variables: 


e Hardware 


Private LANs were utilized for the testing. Other traffic on the LAN would 
have skewed the accuracy of our results. 


No LAN bridges existed between the client and server nodes. Bridges 
would have added another hardware variable to our performance 
equation. 


All LAN adapter cards were the IBM token-ring 16/4 Adapter/A (FRU 
53F 7748) cards configured for 32KB of shared memory. These cards were 
chosen to maximize performance. 


You should note that there are effects on performance due to using this 
adapter in systems with different processor speeds. The IBM token-ring 
16/4 Adapter/A is a shared memory design. This design taps the proc- 
essing power of the main system processor to move data, process 
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network requests, and manage network message control blocks. There- 
fore, this adapter will appear to perform better when installed on a 
system with more main processor power. In such an environment, it is 
not the adapter that is providing improved performance. Rather, the 
improved performance is due to the main system processor. 


OS/2 EE Communications Manager 


— There was not any performance improvement when using OS/2 EE 1.3 


Communications Manager instead of OS/2 EE 1.2 Communications 
Manager in execution of the APPC performance benchmarks. Therefore, 
OS/2 EE 1.2 Communications Manager was used as the foundation for 
providing test results. 


The CONFIG.SYS file used for all base OS/2 EE 1.2 Communications 
Manager testing was the default as given by OS/2. The CONFIG.SYS file 
used for all Networking Services/2 testing was the default as given by 
OS/2 with Networking Services/2 installed. 


In order to maximize the OS/2 time slice given to our benchmarks, we: 


- Minimized the number of processes executing in each node. To this 
end, CPU monitoring was performed on subsequent testing. 


- Executed the benchmarks from a full screen environment. By default, 
OS/2 gives an inordinate number of cycles to the currently “active” 
screen group. By executing the benchmarks from the active full 
screen, any cycle stealing by Presentation Manager (PM) was also 
minimized. 


Communications Manager and Networking Services/2 Configurations 


See section D.1, “OS/2 EE 1.2 Communications Manager Configuration 
(.CFG)” on page 279 for Communications Manager configuration spe- 
cifics. This configuration was chosen because it provides for a properly 
tuned Networking Services/2 node as given by the /BM SAA Networking 
Services/2 APPC Programming Reference. 


see section D.2, “Networking Services/2 Configuration (.NDF)” on 

page 282 for Networking Services/2 configuration specifics. This config- 
uration was chosen because it was the simplest that met our connectivity 
needs. 


Nodes were configured as network nodes (NN) for Networking Services/2 
testing. Configuring Networking Services/2 nodes as NNs instead of as 
end nodes (EN) is inconsequential as far as these performance 
benchmarks are concerned. 


TPs were configured as operator started for base OS/2 EE 1.2 Communi- 
cations Manager testing. TPs were configured as operator pre-loaded for 
Networking Services/2 testing. This approach was chosen to eliminate 
the server TP disk load time from measurement. This disk delay would 
have dominated the overall timing in each benchmark. 


In the real world, it is unreasonable to assume that all server TPs will be 
configured as operator pre-loaded. You can take a number of steps to 
minimize disk delay on the server: 


- Execute server TPs as background processes whenever possible. 
TPs requiring screen I/O are started and terminated much slower by 
OS/2 than those TPs that execute in the background. 


Our benchmark TPs were executed from a full screen because we 
guaranteed that only one application TP in each node (i.e. one OS/2 
process) would be active at a time. However, we observed that 
when the benchmark TPs were executed in parallel, the fastest per- 
formance times were achieved when the TPs were executed without 
a screen group. 


- Install OS/2 EE 1.3. File load times are greatly improved over OS/2 EE 
1.2. 


- Install the High Performance File System (HPFS). The HPFS is a 
marked performance improvement over the more conventional File 
Allocation Table (FAT). 


- Use the fastest available hardware. At present, that hardware is the 
Model 90 XP 486 and Model 95 XP 486 family of processors. In brief, 
these systems incorporate 25-33Mhz 80486 processor speeds with 
SCS! 320MB hard drives and disk caching algorithms that provide 
disk access delays that are an industry leader. 


— For Networking Services/2 testing, the IBM-supplied mode #BATCH was 
used for the File Transfer and Pipeline benchmarks. All other 
benchmarks used the IBM-supplied mode #INTER. Under Networking 
Services/2, these modes optimally tune the RU size to accommodate the 
frame size configured for the link. 


For base OS/2 EE 1.2 Communications Manager testing, modes were 
defined that matched the implicit Networking Services/2 mode definitions. 
See section D.1, “OS/2 EE 1.2 Communications Manager Configuration 
(.CFG)” on page 279 for details concerning these mode definitions. 


e Benchmarks 
— The following sequence was adhered to for our testing: 
1. The communications manager for the client and server were started. 


2. For Networking Services/2 testing, the links were explicitly activated 
and sessions were explicitly CNOSed up for both the #BATCH and 
FINTER modes. Links are implicitly established and sessions 
CNOSed up for base OS/2 EE 1.2 Communications Manager testing. 


3. The server benchmark TPs were serially executed from a full screen. 
4. The client benchmark TPs were serially executed from a full screen. 
5. Client benchmark timings were used as our results. 


— A-verb buffer size of 16KB bytes was used for the file transfer 
benchmark. All others tests used a verb buffer size of 100 bytes. These 
verb buffer sizes were chosen because these settings minimized the 
number of APPC API crossings. 


Benchmark Descriptions 


This section provides brief descriptions and flow diagrams for benchmarks used 
in this performance study. 
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Credit Check Transaction (Confirmed Delivery) | 
The Credit Check transaction is typically used when a client program must 


_request permission to perform a specified function. It is used in situations when 


the probability that the server will grant permission is much larger than the prob- 
ability that the server will not grant permission. 


This transaction differs from the Inquiry transaction in that no data is returned by 
the server; the server simply returns an acknowledgement that the data sent by 
the client program was successfully received and processed. 


This transaction is also used when a client program needs to send information to 
the server, and needs a guarantee that the information has been successfully 
received and processed. That is why it is called the “Confirmed Delivery” trans- 
action. 


The following diagram illustrates the data flows for the Credit Check transaction. 


100 Bytes 


Client Confirmed Server 


Figure 70. Data Flows for the Credit Check Transaction 


The Inquiry Transaction (Request and Reply) 

The Inquiry transaction is typically used to request information from a server 
program. This transaction is also known as “Request and Reply,” because the 
entire conversation is made up of one request and one reply. Aclient sends a 
request to a server which obtains the answer and replies. 


The following diagram illustrates the data flows for the Inquiry transaction. 
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Figure 71. Data Flows for the Inquiry Transaction 


The Database Update Transaction (Conversational Reply) 

The Database Update transaction is typically used to update information 
managed by a partner program. It is used in database applications where a 
client program requests information from the database server, updates the infor- 
mation, and returns the update to the server to be set into the database. 
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This transaction is really an Inquiry transaction followed by a Credit Check trans- 
action performed on the same conversation. It shows the transfer of responsi- 
bility between the client and the server. A single conversation is used to control 
the scope of recovery. 


This same transaction may be used when a client requests information from a 
server and the server, in turn, requests information (usually for accounting or 
auditing purposes) from the client. In this case, the server appends the new 
request to the reply sent to the original request and the result is returned in a 
another record. In this environment, this transaction is called a “Conversational 
Reply” because the reply solicits an additional reply from the originator. 


The following diagram illustrates the data flows for the Database Update trans- 
action. 
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Figure 72. Data Fiows for the Database Updaie Transaction 


The Pipeline Transaction (One Way Bracket) 

This transaction is generally used to send a message to which a reply is not 
expected. The client sends a chunk of data and then leaves. There is no posi- 
tive acknowledgement of the data. Importantly, if the application does include a 
reply (for instance, at a later time), the programs must correlate their requests 
and replies across conversations, because there is no indication at the client 
that the server completely processed the incoming record, or even received the 
record. It may be used where the application complexity and APPC resource 
trade-off is made in a way to minimize the APPC resources. Your throughput 
requirements may be too high to have a separate session for every partner. 


The following diagram illustrates the data flows for the Pipeline transaction. 
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Figure 73. Data Flows for the Pipeline Transaction 
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The File Transfer Transaction (Batch Send) 
This transaction is an extended version of the Credit Check transaction. 


The File Transfer transaction is typically used to send relatively large amounts of 
data from one location to another. It is used in situations where several related 
data records need to be moved. It is also called the “Batch Send” transaction, 
because a batch of records is sent at the same time. 


The following diagram illustrates the data flows for the File Transfer transaction 
using a 4Mbps LAN. 
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Figure 74. Data Flows for the File Transfer Transaction over a 4Mbps LAN. The total 
data transferred from the client to the server is 16KB or 100KB. 


The following diagram illustrates the data flows for the File Transfer transaction 
using a 16Mbps LAN. 
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Figure 75. Data Flows for the File Transfer Transaction over a 16Mbps LAN. The total 
data transferred from the client to the server is 16KB or 100KB. 
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Chapter 13. Debugging 


In this chapter we will discuss how to find out what went wrong in your network 
definitions. | 


First, we list some general considerations about the basic checks to do, and then 
we will consider the tracing facilities. The last section of this chapter indicates 
the information IBM service will need if you are going to report the problem. 


13.1 Hints and Tips 


The following paragraphs list some checks that you should do if you get in 
trouble. These checks should be done before using the tracing facilities when- 
ever possible: 


Adapter 
e« The largest frame size that can be used by an IBM token-ring adapter is set 


by configuring the adapter: if you do not want the default you must boot the 
reference diskette and change the configuration to map all of its RAM 
memory. This will allow you to use the largest size in the IEEE 802.2 profile. 


Address 
e Verify the addresses that are being used. For instance, if you are using a 


token-ring LAN, look at the C:\CMLIB\ACSLAN.LOG, to check your address 
on the LAN. Are you defined to other nodes with this address? 


Files 


Does the .CFG file that appears in your CONFIG.SYS match the one you are 
really using in Communications Manager (or at least, if you are on a token- 
ring LAN does this .CFG file contain the same adapter address in its IEEE 
802.2 profile)? 


Do the .CFG and .NDF files have the same filename? 


e Are you running the .CF2 that was built with the .NDF you intend to use? 


If you have built or modified your .NDF file through the Presentation Manager 
interface, check the result with an editor. . 


Node Definition File 


© Copyright IBM Corp. 1991 


Each verb you put in your .NDF file has default values for its undefined 
parameters. These default values are written in the APPNV.CTL file (see 
Appendix A, “File APPNV.CTL” on page 1917 ). 


There are default values for alias, LU, PLU, and mode. 


The complete explanations for every verb and parameter and their defaults 
are in the Networking Services/2 System Management Programming Refer- 
ence. 


There are default transaction programs. If a TP name is not explicitly associ- 
ated with an executable .EXE file, it is associated by default with an execut- 
able .EXE file whose filename is the TP name (see section 8.7, “Default TPs” 
on page 113). 
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If you want to define a .CMD as a remotely startable transaction program, 
you must specify FILESPEC(C:\OS2\CMD.EXE) and PARMSTRING(/C 
filename.CMD parameters). This may be done from the Configuration Man- 
agement window by selecting Advanced SNA and then Transaction Programs. 


The connection between a DEFINE PARTNER_LU and a 

DEFINE _LOGICAL_LINK is accomplished with a CP name. The value you 
specify on the FQ OWNING CP_NAME parameter on a DEFINE PARTNER_LU 
must match the value specified on the FQ_ADJACENT_ CP_NAME parameter 
on the DEFINE LOGICAL_LINK. 


Cleaning the Node 
e If you want to be sure that a network node only contains what you have 


defined in the .CF2 built with your .NDF, you must first stop Communications 
Manager and then erase the saved directory C:\CMLIB\APPN\APPCDS.DAT 
and restart Communications Manager. However, the node will still dynam- 

ically learn the topology from its neighbors. 


Running | 
e Use the Display window to check the current configuration. 


e Check the state of your links. Use the Configuration Management window 


Dynamic Updates 


and choose APPN and then Subsystem Management to activate or deactivate a 
link. 


The LU alias is used by the local program. Only the LU name gets sent in 
the bind. The same for situation applies for the PLU alias and name. 


CP name check is performed during the XID exchange whenever the 
ADJACENT NODE TYPE is not LEN. 


When you modify the .NDF, you may have done modifications that cannot be 
used to update the current configuration when you run the verification with 
the update option or select Update on the Presentation Manager interface. To 
have such modifications take effect, stop and restart Communications 
Manager. | 


No dynamic updates to your running configuration interfere with anything 
active in your configuration. In some cases the information affected by the 
dynamic update will be made pending the completion of a running TP or 
session. For example, when you change something for a mode, it creates a 
new mode definition. However this mode definition will not go into effect 
until all the sessions started under the old definition have been terminated. 


Directory 
e The LUs known in your workstation are shown in the directory (use the 


PMDSPLAY window). 


e The directory database is saved on disk only in network nodes. It is saved 
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every 20 updates to the directory cache. This frequency cannot be changed. 
It is also saved when you exit Communications Manager (exit immediately or 
exit when complete) and when you use the Desktop Manager shutdown 
facility. So, if you want to clear out the directory in a network node, erase it 
after you have taken down Communications Manager. The file where the 
directory is saved is C:\CMLIB\APPN\APPCDS.DAT. 


Topology 
e The topology information resides only in network nodes. It is never saved: 
When you power on a network node, it dynamically learns the topology from 
its neighbors. 


Subarea 
e If you go through a subarea network, be especially careful if you use defaults 
in the APPN network, and check that the subarea network knows: 


— The modes you use (you may use a special logon mode table as in 
Figure 35 on page 103) 

— The LUs which have sessions through the subarea network. For instance 
if you use APPCTELL.EXE, your local default LU must be defined in the 
subarea network. 


e The network node that connects an APPN network to a subarea must have 
ADJACENT NODE_TYPE(LEN) on the DEFINE LOGICAL LINK that goes to the 
subarea. If not, Networking Services/2 will perform CP name checking when 
it exchanges an XID and if the subarea does not send a matching CP name, 
your link will not activate. With ADJACENT NODE TYPE(LEN), CP name 
checking will be bypassed and you can use any CP name value to make the 
connection between the DEFINE PARTNER_LU and the 
DEFINE LOGICAL LINK. 


e |If a node has a link to a subarea that will be used by 3270 emulation, the 
verification process overrides what is in the .NDF file and sets 
SOLICIT SSCP_SESSION(YES). 


Error Messages, APPC Return Codes and Sense Codes 
e Use the Communications Manager messages. From the first screen of Com- 
munications Manager select: 


Message 
Display messages 


Put the cursor on the message number and press F1 to get a detailed expla- 
nation of the message. Do not forget to look at the preceding messages 
{press F/7). 


e The detailed trace file .DET contains the primary and secondary return codes 
of the APPC verbs, as well as the sense codes. 


e Look for information in every node involved. You may have an error 
message in one node that says something which will make you misunder- 
stand what is happening, while the messages in another node contain the 
answer to the problem. 


For example, we got an “unknown mode” on a requester and the error was 
on the server where the required file did not exist. In that case only the 
traces and messages on the server were useful. 


e For more complete information on error return codes and sense codes refer 
to the Probiem Determination Guide for Networking Services/z2. 
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13.2 The Tracing Facilities 


Networking Services/2 offers an easy way of using the Communications Manager 
tracing facilities. The trace can be controlled from: 


e The Presentation Manager interface, in the Group - IBM SAA Networking 
Services/2 window 

e An OS/2 Command Interpreter 

e A batch .CMD file. 


Two programs are provided: CMTRACE.EXE and FMTTRACE.EXE. Both are 
located in the C:\CMLIB\APPN\ directory. 


The CM Trace Facility 
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The CMTrace command provides command line control over the Communi- 
cations Manager trace functions. With CMTrace you can start and stop tracing of 
particular trace categories and copy a trace to a file. 


Command line control of trace functions is much easier than wading through the 
panels. Also, with CMTrace, you can control the trace functions from a batch 
file. This is very useful for testing (see “Using a Batch Command File” on 

page 186). 


The signification of the system event is often ignored. The following are most 
useful: 


Event 1: internal DLC interface 

Event 2: APPC verbs 

Event 3: internal APPC flows 

Event 4: APPC send and receive 

Event 5: XID flows 

Event 12 : utility verbs such as error log entries. 


Examples 
some examples should make the operation of CMTrace clear: 


cmtrace start /api appc services 


To start tracing the APPC and services APIs. 


cmtrace start /data trnet 
Starts tracing token-ring data. Other traces that were already active (for 
instance API traces) remain active. 

cmtrace stop /data trnet /api services 


Stops tracing the services API and token-ring data. 


cmtrace stop 


stops all tracing. 
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cmtrace copy xyz.trc 


Copies the trace to file ”’xyz.trc” in the current directory. 


Summary 
A summary of the CMTrace command syntax can be obtained by typing: 


cmtrace ? 


This summary is reproduced here: 


CMTRACE - IBM Internal Use Only 
(C) Copyright IBM Corporation 1990. All rights reserved. 


Usage: 


CMTRACE AUTOSTART flags Define autostart trace categories 
CMTRACE START flags Start one or more trace categories 
CMTRACE STOP flags Stop one or more trace categories 
CMTRACE COPY flags file Copy a trace to a file 


The flags are: 
/api, followed by one or more (blank separated) of: 
ACDI, APPC, EHLLAPI, RUI, SERVICES, SLI, SRPI, 
SUBSYSM, X25, X25FRAME 
/data, followed by one or more (blank separated) of: 
DFT, ETHERAND, PCNET, SDLC, TRNET, TWINAXIAL, X25 
/event, followed by one or more (blank separated) numbers 


between 1 and 30 
/key, followed by a 1-8 character key 
/reset, resets the trace buffer. Previous trace records are lost 
/stdout, write the trace data to standard output 
/storage <n>, where <n> is number of 64KB segments for 
trace buffers 
/trunc <n>, where <n> length at which trace records are 
truncated 


The flags that can be used with the various operations are: 


AUTOSTART /key, /api, /data, /event, /trunc, /storage 

START /key, /api, /data, fevent, /reset, /trunc, /storage 
STOP /key, /api, /data, /event 

COPY /key, /stdout 


Case is immaterial in all flags and keywords. Flags and 
keywords may be abbreviated so long as they remain unique. 


The AUTOSTART must be used when you want to trace what is happening during 
the Communications Manager initialization. There is something special about 
AUTOSTART: you cannot stop it with the CMTRACE STOP command. The only 
way to stop it is to go in the Communications Manager panels and to select: 


Advanced 
Problem determination aids 
Trace services 
Auto-trace services... 
Disable auto-trace 
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In fact it is easier not to disable the auto-trace but to make it trace nothing! You 
do it by typing AUTOSTART without flags; the result is the same as when you really 
disable the auto-trace. — 


The Format CM Trace Facility 


FmtTrace is an OS/2 program that formats an OS/2 Communications Manager 
trace file into human-readable form. It formats trace records for the APPC API, 
APPC send events, and DLC data. 


Two forms of formatted output may be produced: a summary file in sequence 
diagram form with one line per trace event, and a detail file with one line per 
formatted field. | 


The FmtTrace Command 
The FmtTrace command has the following form: 


fmttrace /flags file 


The optional “flags” control the FmtTrace output, and “file” identifies the trace 
input file. 


Note: The “flags” must appear before the filename. They will be ignored if they 
follow the filename. 


FmtTrace will give a summary of its command syntax if invoked as: 


fmttrace ? 


The summary is written to stdout and is longer than 24 lines. You may want to 
redirect it to a file or pipe it through “more” if your screen has only 24 lines. The 
summary is reproduced in “Summary” on page 184. 


Flags 

Flags are optional and must be preceded with a ”/”. Each flag can have its own 
”/”, or the flags can be run together with a single leading ”/”. The FmtTrace 
defaults for the flags remain in effect until explicitly overridden in the command. 


Output file type selection: FmtTrace can produce a summary output file and/or 
a detail output file. The following flags select the output file type: 


/D Produce a detail output file 

Id Don’t produce a detail output file (default) 
[Ss Produce a summary output file (default) 
Is Don’t produce a summary output file. 


The defaults for these flags are ’/S /d”. 


Output formatted event type selection: FmtTrace divides the formatted trace 
events into two types: 


e APPC API 
¢ DLC data, including XIDs (also called line flows). 


The following flags select the trace event types that will be formatted: 


IA Format the API trace (default) 

la Don’t format the API trace 

IF Format the line flow trace (default) 
if Don’t format the line flow trace. 
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The defaults for these flags are ”/A /F”. 


Selection of trace records based on !D: Most APPC verbs have associated 

transaction program and conversation IDs. DLC data has an associated LFSID in 

the TH. Trace records can be included or excluded from formatting, based on 

their ID. The following flags select the trace records to be formatted, based on 

ID: 

!TXxxxxxxx Format the APPC API trace records with a TP ID matching 
XXXXXXXX(hex) 

[txxxxxxxx Don’t format the APPC API trace records with a TP ID matching 
XXXXXXXX( hex) 

ICXxxxxxxx Format the APPC API trace records with a conversation ID matching 
XXXXXXXx(hex) 

/Cxxxxxxxx Don’t format the APPC API trace records with a conversation ID 
matching xxxxxxxx(hex) 

/Lxxxxx Format the DLC data trace records with a send LFSID matching 
XXXxXxX(hex) 

IVXXXXxX Don’t format the DLC data trace records with a send LFSID matching 
Xxxxx(hex). 


There are no defaults for these flags. By default records are formatted inde- 
pendent of their ID. | 


The flags ”/T”, “/C” and ”/L” are called include flags. The flags ”/t’, ’/c” and ”/I’ 
are called exclude flags. An include flag cannot be specified with its corre- 
sponding exclude flag. The flags are additive: ”"/Cxxxxxxxx /Cyyyyyyyy” 
includes verbs with a conversation of Xxxxxxxx Or yyyyyyyy. 


Only the first four bytes of the TP ID are used for selection. Some verbs do not 
have a TP and/or conversation ID. The LFSID is defined to be (ODAI,DAF,OAF). 
Note that the include/exclude LFSID is specified for the send direction. In SNA, 
the OAF and DAF bytes are reversed in each data direction. XIDs and inter- 
process signals do not have IDs and cannot be subsetted. 


Miscellaneous Flags 


/H Use uppercase alphabetics in hex output: “OXBC2F” 
th Use lowercase alphabetics in hex output: “Oxbc2f”. 


The defaults for these flags are ”/h’. 


Input Trace File 

The “file” parameter identifies the trace input file. It may optionally include 
drive, path, and extension information. If not specified, the drive and path 
default the current drive and path, and the extension defaults to ”.trc”. Wildcard 
characters cannot be used in the “file” parameter. 


The input file drive/path/name are used as drive/path/name of the output file(s). 
The summary file has the extension .SUM and the detail file has the extension 
.DET. 


A “file” parameter value of ”/” is special and tells FmtTrace to get its trace input 


from stdin. In this case, the output files are fmttrace.sum” and fmttrace.det” in 
the current drive and directory. 


Chapter 13. Debugging 183 


184 


Examples 
Some examples should help in understanding the operation of FmtTrace: 


fmttrace sample 


Format “sample.trc” and produce a summary trace of the APPC API and DLC 


data in “sample.sum”. 


fmttrace / 


Format the data read from stdin and produce a summary trace of the APPC 
API and DLC data in fmttrace.sum’. 


fmttrace /D c:\cmlib\sample.out 


Format ’c:\cmlib\sample.out” and produce a summary trace of the APPC API 
and DLC data in ”c:\cmlib\sample.sum” and a detailed trace in 
”“c:\cmlib\sample.det”. 


fmttrace /Ds sample 


Format “sample.trce” and produce a detailed trace (only) of the APPC API and 
DLC data in “sample.det”. 


fmttrace /D /s sample 


Same as above. 


fmttrace /L00301 /TO0008fic sample 


Format “sample.trc” and produce a summary trace (only) of the APPC API for 
the transaction program with ID Ox00008fic and DLC data for the session with 


send LSFID 0x00301 in “sample.sum”. 


The recommended usage is: 


fmttrace /D trace 


Summary 
A summary of the FmtTrace command syntax can be obtained by typing: 


fmttrace ? 


This summary is reproduced here: 
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FMTTRACE 
(C) Copyright IBM Corporation 1990, 199] 


fmttrace </flags> file 

where flags are: 
D(d) - produce (don't produce) a detail file 
S(s) - produce (don't produce) a summary file 
A(a) - format (don't format) the API trace 
P(p) - format (don't format) the CPI-C trace 
F(f) - format (don't format) the line flow trace 
R(r) - format (don't format) TestRTS 
T(t)XXXXXXXX - include (exclude) verbs with matching 
TP ID 
C(c)XXXxXXXxx - include (exclude) verbs with matching 
conversation ID 
L(1)xxxxxxxx - include (exclude) flows with matching 
LFSID 
H(h) - use uppercase (lowercase) alphabetics in hex 
output 

the default flag setting is /SdAPFRh 


file is the name of the input trace file. The file extension 
defaults to .trc. 

If the D flag is specified, a file with the same name 

and extension .det is produced. 

If the S flag is specified, a file with the same name 

and extension .sum is produced. 

If the file is specified as '/', input is read from stdin 

and the output files, if any, are fmttrace.det and fmttrace.sum 


FmtTrace Input 

The input file for FmtTrace is an OS/2 Communications Manager trace file. It 
can be created with the Communications Manager panels or with the CMTrace 
program. For convenience in using FmtTrace, it is recommended that the trace 
file have a file extension of .TRC.. 


FmtTrace can format trace records for the following trace types: 


e APPC API 

e DLC data 

e APPC verbs 

e APPC send and receive 
e XID flow. 


_ Records for all other trace types are ignored by FmtTrace. 


FmtTrace Output 

Only the sending of the interprocess signal is shown. FmtTrace recognizes all 
SC, DFC and NS RUs. In addition, for normal FM data, it recognizes LU 6.2 FMHs 
and some GDS variables. 


FmtTrace treats each line flow trace record independently. In particular, it does 
not try to reassemble RUs that have been segmented or GDS variables that have 
been broken into separate RUs. What this means is that FmtTrace will try to 
format a line flow only if it represents the first segment in the first RU in a chain. 


For example, if a long BIND RU is segmented into two line flows, FmtTrace will 
format the first segment, but it will Know nothing (other than the contents of the 
TH) about the second segment. 
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Summary File 
Since the summary file can be wide {> 80 columns), the first character of the 
summary file is OxOf, to enable condensed printing on a ProPrinter. 


The summary file contains one line per formatted trace record. The summary is 
in the form of a sequence diagram. Each line contains the line number of the 
input trace file, the IDs (TP/conversation ID for API, LFSID for DLC data), if any, 
for the trace record and an annotated arrow. 


Right pointing arrows represent verb requests or sent line flows. Left pointing 
arrows represent verb replies or received line flows. Interprocess signals have 
no arrowheads. 


The arrows are annotated with the verb or flow name. In the case of verbs, the 
verb name may be followed by additional parameters in parentheses. If a verb 
reply has a non-zero return code, the primary return code is shown in hex. 


For verb requests and replies with a zero return code, the additional parameters 
are as follows: 


Allocate(rq) Partner LU alias, mode name, TP name (truncated to eight charac- 
ters, if necessary) 


Confirm(reply) Rts (if request to send received) 

Dealloc(rq) Type 

PrepRcv(rq) Type, Locks 

RcvAlloc(rq) TP name (truncated to eight characters, if necessary) 
RcvAllioc(reply) LU alias, Partner LU alias, Mode name 
RevWait(rq) Fill, Max length 


RcvWait(reply) Status received, Data received, Rts (if request to send received), 
Data length 


Rcevimmed Same as RcvWait 

SendData(rq) Data length, Type 

SendData(reply) Rts (if request to send received) 

TpEnded(rq) Type 

TpStrted(rq) LU alias, TP name (truncated to eight characters, if necessary). 


Detail File 


The detail file has one line per formatted field. 


Using a Batch Command File 


186 


When you do debugging, it is often easier to use batch command files, rather 
than typing the same things repeatedly under the OS/2 Command Interpreter. 


Here are two samples you can use to build your own batch files. 


The first command file, TRC.CMD, starts the trace, while the second command 
file, FMT.CMD, stops the trace, copies it to a file and formats it. 


The options that have been chosen are recommended. 
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TRC.CMD 
CMTRACE START /reset 


/api appc services 
/data ibmtrnet 
fevent 5 12 

/storage 3 


This will trace XID flows (event 5) and the utility verbs (event 12). 


The following program supposes that you have defined a directory named 
TRACES on your D: disk. This program takes the filename of the trace as a 
parameter and stores it with the detail and summary in D:\TRACES\. 


FMT.CMD 


a: 

cd \traces 

CMTRACE STOP 
CMTRACE COPY %1.trc 
FMTTRACE /D %1 


Networking Services/2 provides two sample batch command files, APPNT.CMD 
and APPNF.CMD, located in C:\CMLIB\APPN\ subdirectory: 


APPNT.CMD 
| CMTRACE START -reset -api appc services -data ibmtrnet -event 1 2 3 4 5 12 


APPNF.CMD 


CMTRACE STOP 
CMTRACE COPY %1.tre 


FMTTRACE -DS %1 
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Example of utilization: Here is an example of how to use these batch programs. 
We suppose you want to trace what happens when you send a message with 
APPCTELL.EXE from an end node EN to a network node NN through an interme- 
diate network node NNi. 


@oeeeoeeeoeeedo 8 


¢ Subarea ° 
« Network ° 


eeee ee eoeoee 


sender inter receiver 


message 


To take a trace on each machine, you must type the following commands without 
forgetting to respect the sequence: 


APPCTELL NN message 


FMT sender FMT inter 


The traces you will get are: 
e For EN1 


— sender.trc 
— sender.sum 
— sender.det 


e For NN 


— inter.trc 
— inter.sum 
— inter.det 


¢ For EN2 


— receiver.trc 
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— receiver.sum 
— receiver.det. 


You will find some of these traces in the appendix (Appendix C, “Traces” on 
page 259). 


13.3 What Is Required to Report a Problem to IBM Service 


If you can’t determine the cause of a problem, the following documentation is 
required for problem analysis: 


1. A description of the problem. 


2. Message and error logs: a description of the messages that were present or 
missing). Copies of \CMLIB\MESSAGE.DAT, \CMLIB\ERROR.DAT, 
\CMLIB\yourconfig.CFG, \CMLIB\APPN\yourconfig.NDF are desirable. You 
will have to exit Communications Manager to make the copies. 


3. The system level: the command SYSLEVEL tells the level and CSDs of OS/2 
and Networking Services/2. Under the OS/2 Command Interpreter type: 
SYSLEVEL > SYSLEVEL.DAT to put this information in the file SYSLEVEL.DAT. 


4. A trace taken when the problem occurred: 


a. Start tracing with the following command: CMTRACE START /RESET /API appc 
services /DATA ibmtrnet /STORAGE 4 /EVENT 1 2 3 4 5 12 


b. Recreate your problem 


c. Stop, copy and format the trace to a file : 


CMTRACE STOP 
CMTRACE COPY PROBLEM. TRC 
FMTTRACE -DS PROBLEM 


5. Contact IBM service. 
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Appendix A. File APPNV.CTL 


This appendix contains the file APPNV.CTL which is located in the 


C:\CMLIB\APPN\ directory. 
// This file serves two purposes. It gives a description of the node 
// definitions file and the format of the commands that can be placed in this 
// file. This file also defines the command, parameter, and value names 
// that are allowed in the node definitions file, along with the delimiters 
// used in the node definitions file to separate commands, parameters, 
// values, and comments. You can customize the format of the commands and 
// delimiters used in the node definitions file by changing the delimiters and 
// keywords contained within this file (the configuration control file). 
/} 
// AS you may have already guessed, this file is a free-format (not column or 
// line dependent) file. Comments are allowed in this file and the node 
// definitions file by using the (//) delimiter to comment an entire line. 
I} 
// The node definitions file also allows the (/* */) delimiters to comment 
// a section of a line or extend a comment over several lines. For example: 
// 
// [* This is an allowed comment. When using (/*), all characters are ignored 
// until the matching end comment delimiter is given: */ 
// 
// The (/* */) form of commenting lines is NOT supported within this file 
// because it would limit the values you could specify when configuring your 
// delimiter vaiues (see beiow). 


// 

/1 WARNING: Comments are ignored when the node definitions file is parsed, 
// so any utilities that create or re-create the node definitions 

/} file will erase all comments in the file. Use the DESCRIPTION 

// parameter to annotate your configuration files, or make backups 

I} of your files so that when they are re-written you can restore 

// the comments. The APPNC.EXE, APPNRST.EXE, and APPNMIG.EXE 
// utilities will all replace the node definitions file. 

I} 

1 Lacetametcatetatatataiataataaaniatatanacaaiaatatmaneaatatammmanataattatmetmataamenmmtammmmemmmtaate 

| | ennnnnnnnn anne nnn nn nnn nnn nn nnn nnn nnn nnn nnn enn nnn nn nnn nnnennenennnnna= 

| |----------------------- The NODE DEFINITIONS FILE -------------------------- 

| | nnnnnnnnnn anne nnn nnn nn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nn nnnnnnnne 

| Loraarataaaaiatatatataateaiatatataatntantatenmamaaiatatamatammaatataaataaemmeataammmntttemmmeerats 

// 


// The node definitions file is a free-format file containing the commands 

// used to define a Networking Services/2 configuration. The syntax of these 

// commands are defined using the information in this file, along with the 

// values of the delimiters used to delineate the information in the file. The 

// commands in the file can be specified in any order. Likewise, spaces are not 

// significant in the node definitions file unless explicitly stated for a 

// particular command, parameter, or value. For example NODE _TYPE(EN) is the 
// same as NODE_TYPE (EN _). 

// 

// This file defines the syntax of the node definition commands. For more 

// information on the commands and the system management verbs they represent, 
/i refer to the Networking Services/2 System Management Programming Reference 
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// (8C52-1111). There will be some differences between the syntax of the node 

// definition commands and their corresponding system management verbs. Some 

// of the verb parameters may be combined into a single command parameter 

// parameter (for example, the xxx_MIN and xxx_MAX parameters of the DEFINE COS 
// verb are combined into the xxx_RANGE parameters of the DEFINE COS command) 
// or are implied and not explicitly specified on the command. Another 

// difference is that the configuration utilities will handle all conversions 

// from ASCII to EBCDIC when reading the node definitions file, and will 

// perform any necessary padding of values. 

// 


// The following delimiter characters are used in the node definitions file: 
i] 
// Delimiter character name default value Description 


[| wnnnnnnnnnnennnennennnne emcee ee eeere ence enn eee 

// LPAREN ‘U, x’28’ Left parenthesis 

// RPAREN ‘y’, x29’ Right parenthesis 

// COMMA Gee Comma 

// SEMI "xX 3B’ Semicolon 

// SLASH rake Forward slash 

// ASTERISK ea 67). Asterisk 

// QUOTE aie 4/7 id Single quotation mark 
// BLANK 7) x’20’ Blank 

// 


// The value for these delimiters is defined in this file, and can be changed 
// if you want to (excluding the BLANK delimiter). Unfortunately, these 

// delimiters are referenced in this section when describing the format of the 
// node definitions file. This section will use the delimiter description 

// followed by the delimiter character name to identify delimiters. For 

// example, left parenthesis (LPAREN) refers to the ’{’ character if you are 
// using the default delimiter definitions. 

ih 

// A few of the delimiters are used in combination with other delimiters or 

// characters to form other delimiters. These combinations are: 


// 

// Complex delimiter name Description of syntax Default value 
|| ia aratataetaaaetatatatarareaaeaaecaatatatataiatataeataaaaataatmanatatammeamtaamemmmme 

// LINE COMMENT A forward slash (SLASH) followed /} 
// by another forward slash (SLASH) 

// LEFT COMMENT A forward slash (SLASH) followed i 
// by an asterisk (ASTERISK) 

// RIGHT COMMENT An asterisk (ASTERISK) followed of 
// by a forward slash (SLASH) 

// HEX INDICATOR The letter x (in upper or lower X’ or x’ 
fh case) followed by a single 

// quotation mark (QUOTE) 

// 


// The values of these delimiters are implicitly changed when you change the 
// values of the character delimiters. These delimiters will be referred to 

// within this file using their complex delimiter name. The value of the 

// letter x is not configurable (x’78’ lower case, x’58’ upper case). 

fi 

// The value of these delimiters can be any valid “printable” ASCII character 
// (Ox20 - OxFF) except for the following characters: 
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// 


/] a-z lowercase letters 

// A-Z uppercase letters 

// 0-9 digits 

/] "” space (this is always set to the blank (BLANK) delimiter) 
// ’.” period 

/} ’$’ dollar sign 

/] ‘# pound or numeric sign 

// ‘@’ at sign 

/f ’ colon 

// ‘\’ back slash 

// 

// Note: Changing the value of the LINE COMMENT, LEFT COMMENT, or RIGHT COMMENT 
// delimiters does NOT change their values within this file. This file 
// always uses the default settings for these delimiters. 

// 

|| ----------------------- General Command Syntax ------------------------------- 

/} 


// The general format of a command is the command name, followed by one or more 
// command parameters, and terminated with a semicolon (SEMI). The parameters 
// may be specified in any order. The general format of a command parameter is 

// the parameter name, followed by the parameter value enclosed in a left 

// parenthesis (LPAREN) and right parenthesis (RPAREN). Parameter values may be 
// one or more numbers, hexadecimal numbers, hexadecimal strings, value 

// keywords, strings, or sub-parameters. 

// 

// Command names, parameter names, and value keywords are all case insensitive 
// (the strings “DEFINE LOCAL CP” and “define_local_cp” both identify the same 

// command). 

I] 


// 

// Numbers may be specified as unsigned decimal values (e.g. 256) or 

// as hexadecimal numbers (which are translated to their integer equivalent). 

// Integer numbers consists of one or more of the decimal digits 0 - 9. 

/} 

// Hexadecimal numbers are specified by enclosing two or more hexadecimal digits 
// (O-9, a-f, A-F) within a HEX INDICATOR and a single quotation mark 

// (QUOTE). For example, using the default values for the delimiters, a valid 

// hex number would be X’2B’. x’2b’ would indicate the same hexadecimal value. 
// Hexadecimal numbers must be specified using an EVEN number of hexadecimal 
// digits. 

I} 

// Hexadecimal strings are specified the same as hexadecimal numbers except 
// hexadecimal strings may be specified using an EVEN or ODD number of 

// hexadecimal digits. 

/} 

// Value keywords are specified using the names of the keywords (specified 

// in this file). Value keywords are used to indicate a specific value without 

// worrying about its internal representation within Networking Services/2. 

// When describing the syntax of the commands (see below), the allowed value 

// keywords for each parameter will be given. 

// 

// Strings are specified as one or more characters (making sure the characters 

// are part of the character set valid for that parameter). Specify string 
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// values as is, do not enclose them in quotes, etc. You may specify a string 

// with the same value as a command name, parameter name, or value keyword. 

// 

// For example, (using the default values), EN is a value keyword which can 

// be specified for the NODE_TYPE parameter of the DEFINE LOCAL _CP command. 
// The Networking Services/2 support will translate the value keyword | 
// EN into some internal representation. The value of the CP_ALIAS parameter 

// of the DEFINE LOCAL CP command is specified using a string. Therefore, 

// specifying EN for the CP_ALIAS parameter, will instruct the Networking 

// Services/2 support to use the actual string “EN” for the control point 

// alias name. 

// 

// Most parameters that accept strings as their values also restrict the 

// characters that may be specified in the string (referred to as the parameter 

// character set). The next section describes the character sets used in the 

// node definitions file. 

// 

// Sub-parameters are used when a parameter is actually a set of parameters. 

// Sub parameters are specified the same as parameters and can take on any of 

// the values a parameter can, including sub-parameters. For example, (using 

// the default values), the value of the ADAPTER_INFO parameter of the 

// DEFINE_CONNECTION_NETWORK command is two sub-parameters (DLC_NAME and 
// ADAPTER_NUMBER). To specify a ADAPTER_INFO parameter which uses a DLC named 
// IBMTRNET and adapter number 1, you would specify: | 

/} 

// ADAPTER_INFO (DLC_NAME(IBMTRNET) ADAPTER_NUMBER(1)) 

/} 

// Finally, some parameters accept (or require) more than one value, where the 

// values are not sub-parameters. The values are specified as a list of values 

// separated by commas (COMMA). For example, (using the default values), the 

// value of the COST_PER_BYTE_RANGE parameter of the DEFINE COS command is 
// actually two numbers. Therefore, to specify a range between 0 and 255, you 

// would specify: | 


// | 

// COST PER_BYTE_RANGE(0,255) 

/] | 

|]-------------- Notes on string values and their character sets --------------- 
// 

// 

// Some special notes on entering string values: 

// 

// 1) It is not necessary to pad strings with blanks, as required when 
// using the programming interface. The Networking Services/2 
// support will perform any necessary padding. 

I} 

// 2) In some of the string types described below, the allowed 

I] characters include some of the node definition file delimiters. 
// Unless noted in the string definition, the delimiters are not 

// allowed to be a part of the string, even if they are a part of the 
// string’s defined character set. This is the main reason 

// Networking Services/2 allows you to change the delimiter 

Hf definitions. You can change the delimiters such that they no 
// longer clash with the characters you wish to place in your names. 
// strings cannot contain the ASCII line feed (LF), carriage return 
// (CR), tab (HT or VT), or end-of-text-file (x’1A’) characters. 
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/] 3) Type-a strings are entered in ASCII. The Networking Services/2 
// support will translate the strings to EBCDIC. Although type-a 

// strings are uppercase only, the Networking Services/2 support 

i] will accept type-a strings in lower or upper case. They will be 

/} converted to uppercase when they are translated to EBCDIC 

/} (therefore the type-a strings “appn” and ”“APPN” are equivalent). 
/} 

/} Type-a strings consist of the uppercase letters (A-Z), digits 

// (0-9), and the special characters $, #, and @. Fully-qualified 

// names that are type-a strings also allow a period ”.’. 

[] Type-a strings cannot start with a digit. 

/] 

// 4) Type-ae strings are entered in ASCII. The Networking Services/2 
// support will translate the strings to EBCDIC. Type-ae strings 

// are case sensitive, so the Networking Services/2 support will 

// convert mixed case ASCII type-ae strings to mixed case EBCDIC 
// strings. 

/} 

/} Type-ae strings consist of the upper case and lower case letters 
// (a-z, A-Z), digits (0-9), and the special characters $, #, @, and 

// period ’.’. The first character of a type-ae string can be any 

// type-ae character. 

// 

// 5) Character set 01134 strings are entered in ASCII. The Networking 
Ey Sservices/2 support will translate the strings to EBCDIC. 

// Although character set 01134 strings are uppercase only, the 

{7 Networking Services/2 support wili accept character set 01134 

// strings in lower or upper case. They will be converted to upper 
/} case when they are translated to EBCDIC (therefore the character 
// set 01134 strings “appn” and “APPN” are equivalent). 

// 

/} Character set 01134 strings consist of the uppercase letters (A-Z) 
// and digits (0-9). Fully-qualified names that are character set 

/} 01134 strings also allow a period ’.”. Character set 01134 

// strings cannot start with a digit. 

// 

// The Networking Services/2 support allows the ’#’ character in 

// character set 01134 strings to identify IBM-supplied names, 

// although ’#’ is not a part of character set 01134 (first character 
/} only). 

// 

/} 6) Character set 00640 strings are entered in ASCII. The Networking 
// services/2 support will translate the strings to EBCDIC. 

// Character set 00640 strings are case sensitive, so the Networking 
// services/2 support will convert mixed case ASCII character 

// set 00640 strings to mixed case EBCDIC strings. 

// 

// Character set 00640 strings consist of the uppercase and lower 
// case letters (a-z, A-Z), digits (0-9), and the following special 

// characters: 

// 

// ‘” space {not supported by Networking Services/2) 

// *.” period 

// “<’ less than 


Appendix A. File APPNV.CTL 195 


/] ‘>’ greater than 


// ‘C left parenthesis 

// ‘)’ right parenthesis 

// ‘+’ plus 

// ‘-’ dash or minus 

| ‘&’ ampersand 

/] ‘*” asterisk 

// ’’ semicolon 

// ‘/’ slash 

I] ‘’ comma 

// ‘%’ percent 

/I ’_’ underscore 

i} “2?” question mark 

/} “’ colon 

// ‘” single quote 

// ” double quote 

// 3 

// The Networking Services/2 support does not allow the space 

// character in character set 00640 strings, even though the 

// SNA definition of character set 00640 includes the space 

// character. 

// 

// Many of the characters in character set 00640 are also default 
dh delimiters. To minimize these conflicts and the need to redefine 
// the delimiters, the following exceptions have been made for 

// character set 00640 strings: — 

// 

// a) A character set 00640 string can start with any character set 
// 00640 character EXCEPT when the character is also one of the 
// following delimiters: 

// 

/] left parenthesis (LPAREN) 

// right parenthesis (RPAREN) 

/} semicolon (SEMI) | 

// line comment (SLASH,SLASH) 

ff left comment (SLASH,ASTERISK) 

// right comment (ASTERISK,SLASH) (if a comment is active) 

// 

// b) After the first character, a character set 00640 string can 

// contain any character in character set 00640 EXCEPT when 

// the character is also one of the following delimiters: 

// following delimiters: 

// 

// right parenthesis (RPAREN) 

/] line comment (SLASH,SLASH) 

// left comment (SLASH,ASTERISK) 

// 

// 7) ASCII strings can be any valid “printable” character. The 

// Networking Services/2 support allows any character to be specified 
// as part of a ASCII string except characters that are also defined 
// as a delimiter. The forward slash (SLASH), asterisk (ASTERISK), 
// and single quotation mark (QUOTE) delimiters can be a part of 
// an ASCII string as long as they are not combined to form the 

a line comment (SLASH,SLASH), left comment (SLASH,ASTERISK), 
/} or HEX INDICATOR (letter x,QUOTE) delimiters. 
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// some ASCII strings are uppercase only. The Networking Services/2 
// support will accept uppercase only ASCII strings in lower and 

// upper case, and convert them to uppercase. 

// | 

// 8) Free form strings are ASCII strings with fewer character 

/] restrictions. Free form strings can be any valid “printable” 

// character with the following exceptions: 

/} 

// a) A free form string can start with any valid ASCII character 

// EXCEPT when the character is also one of the following 

// delimiters: 

/} 

if blank (BLANK) 

// left parenthesis (LPAREN) 

// right parenthesis (RPAREN) 

i} semicolon (SEMI) 

/} line comment (SLASH,SLASH) 

// left comment (SLASH,ASTERISK) 

if right comment (ASTERISK,SLASH) (if a comment is active) 

/} 

// b) After the first character, a free form string can contain 

// any ASCII character EXCEPT when the character is also one 

// of the following delimiters: 

/} 

// right parenthesis (RPAREN) 

// line comment (SLASH,SLASH) 

if left comment (SLASH,ASTERISK) 

// 

// SPACES ARE SIGNIFICANT IN FREE FORM STRINGS!!! 

// 

}} 9) A few parameters (e.g. MODE NAME) allow a blank name to be 
// specified. Since the node definitions file is free-format, 

// blank (BLANK) characters are ignored (except for free form 

/]/ strings). To specify a blank name, use the BLANK value keyword 
ii (of course, you can change the value keyword BLANK to any name 
// you wish). For example, using the default definitions, to use 

// the blank mode name as the default mode name, specify 

// DEFAULT MODE NAME(BLANK) on the DEFINE DEFAULTS command. 
// 

// 10) Command names, parameter names, and value keywords are case 
// insensitive ASCII strings with the restriction that these names 

is cannot contain any delimiters (either character delimiters 

I} or complex delimiters). 

I] 

| [wonnnnn nnn nn nnn nn nnn nnn nnn nnn nnn nn nnn nnn nnn nnn nnn nnn nner en ennnnnes 

| | wnnnnnnn nn nena nnn nn nnn nn nn nnn nnn nnn nnn nn nn nnn nn nnn nn enn nn nn en nnnenans 

|] -------------------- The CONFIGURATION COMMANDS ---------------------------- 

| | wonnn nn nnn nnn nnn nnn nnn nnn nn nnn nnn nnn nn nnn nn nnn nnn nnn nnn nen enennnne 

| | -nnnn nnn nn enna nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn cennnans 

// 


// Following is a very brief description of the configuration commands, showing 

// each command’s command name, its parameter names, and their value keywords. 
// The names shown here are the DEFAULT names defined in this file. You may 

// customize any of these names to fit your requirements. 
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// 

// Also shown is the syntax of each command, listing all the valid parameters. 

// For each parameter is an indication whether it is required or optional 

// (along with its default value, if one exists), any restrictions/dependencies 
//.with other parameters or their values, and the parameter’s valid values. 

H/ : | | 

// Note: Although the command names, parameter names, and value keywords may 
// be changed, the overall syntax of the commands is not altered. 

I] 

// You can change this section, although this is not recommended. All parameters 
// for a command are shown indented underneath the command name, with an 

// indication to the left of the parameter name indicating whether the parameter 
// is required (R), optional (O), or has special restrictions described at the 

// end of the command description (digit). To the right of each parameter are 

// the allowed parameter values. The special restrictions and default values 

// for the parameters are listed below the command description, along with an 

// example of the command. 


// : 
// Note: Each command example is syntactically correct. The command examples 
// are not meant to be combined to form a viable configuration. 

// 


// All valid value keywords and sub-parameters for a parameter are shown 

// indented underneath their associated parameter name. Unless explicitly 

// stated otherwise, a parameter may be specified only once per command. 

// Likewise, a sub-parameter may be specified only once per PARAMETER (not 
// command) unless explicitly stated otherwise. 


// 

// Note: The required, optional, or restrictions indications applies to the 

// command or parameter “containing” the parameter (in other words, the 
// command or parameter the parameter is indented underneath). For 
// example, a required sub-parameter indicates that if its associated 

// ~~ parameter is specified, then the sub-parameter must be specified as 
// part of the parameter’s value. 

// 

// Note: String sizes are given in byte values. For most languages, a byte is 
// the same as a single character. But some languages use two bytes to 
/} represent a character. Therefore, if you are using a language that 

// uses more than one byte to represent a character, you must take that 
// into account when specifying string values. For example, if your 

// language uses two bytes for every character, you can only specify 

// four characters for an eight byte string value. 

/} 


// Also shown in each command description is whether this command is dynamic. 
// When you verify a configuration (using APPNMIG, which automatically verifies 
// the created configuration, APPNV, or the verify options of APPNC), you can 

// optionally dynamically update the Networking Services/2 active configuration 

// with the new configuration. Therefore, in most cases, you do not have to 

// stop and start the Networking Services/2 support to make your changes active. 
// The verify function will only attempt to update the Networking Services/2 

// active configuration with the dynamic (as indicated below) commands, and only 
// if you specify that the active configuration should be dynamically updated. 

// \f you make changes to commands which are not dynamic, then you must stop and 
// start Networking Services/2 to make your changes active. 

// 
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| | ------------------------- DEFINE LOCAL CP ------------------------------------ 
| | ennnwnnnnnnnnnnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nn nnn nnn renner nena nnn nnnnmmn 

fT. 

// DEFINE LOCAL CP 

//(R) FQ_CP_NAME (3-17 byte type-a string) 

// (must be fully-qualified (netid.name)) 
//{R) CP_ALIAS (1-8 byte ASCII string) 

//{1) HOST_FP_LINK_ NAME (1-8 byte type-a string) 

//(0) HOST_FP_SUPPORT (see keywords) 

I} YES 

iui NO 

//(Q) NAU_ADDRESS (number between 1 & 254 or INDEPENDENT LU) 
// INDEPENDENT LU 

//{(Q) NODE_ID (5 digit hex string) 

//(0) NODE_TYPE (see keywords) 

ii EN 

// NN 

//{O) DESCRIPTION (1-64 byte free format string) 

// 

// Notes: 1) Specify HOST_FP_LINK_NAME only if HOST FP_SUPPORT(YES). 
I 

// Defaults: HOST FP_SUPPORT = (NO) 

// NAU ADDRESS (INDEPENDENT LU) 

/} NODE_ID (X’00000’) 

ii, NODE_TYPE (EN) 

// 

// Dynamic: NO 

if 

// Example: DEFINE LOCAL CP fq_cp_name(appn.home) 

ff cp_alias(home) 

i] host_fp_link_name(homelan) 

// host_fp_support(yes) 

i} nau_address(independent_lu) 

// node_id({x’00001’) 

I} node_type(en) 

I} description(local cp definition for node home); 
if 

// 

| | ennnnn nnn nnn nnn nnn nnn nnn nnn nn nnn nnn nnn nnn nnn nnn nnn nn nnn nn neem nnn nnmnnnn 

| |------------------------ DEFINE CONNECTION NETWORK ----------------- 
| | annnnnnnnn nnn nnn nnn nnn nnn nnn nn nnn nnn nnn nnn nnn nnn nnn nnn nn nen nnn ennnnnn 

// 

// DEFINE CONNECTION NETWORK 

//(R) FQ_CN_ NAME (3-17 byte type-a string) 

// (must be fully-qualified (netid.name)) 
//(R) ADAPTER_INFO (see sub-parameters) 

// (more than one ADAPTER_INFO parameter may 
I} be specified). 

/{R) ADAPTER NUMBER (number between 0 & 255) 
/KKR) DLC NAME | (1-8 byte ASCII string) 

// (The following names are supported by 
// Networking Services/2). 

// IBMTRNET - IBM Token-Ring Network 
// ETHERAND - ETHERAND Network 

// IBMPCNET - IBM PC Network 


Appendix A. File APPNV.CTL 


199 


//(O) DESCRIPTION (1-64 byte free format string) 
// 

// Notes: none 

// | 

// Defaults: none 


// 

// Dynamic: NO 

// 

// Example: DEFINE CONNECTION NETWORK fq_cn_name(appn.cn1) 
// adapter_info(dic_name(IBMTRNET) 

Hf adapter_number(‘)) 

// adapter_info(dic_name(IBMTRNET) 

if adapter_number({0)) 

// description(connection network cn‘); 

// 

] | nneennennnnnnnnnnnnnnnn nnn e enna enema nennn en nnna nnn eenen nn ennenncennnnnennnnans 

| | ennnnnnnnnnnnn nanan nn DEFINE LOGICAL _LINK ------------------------------ 
| | wwnnnnnnnnnnnnn annem nn ne anna anne nna n nee enn nn enn n nnn ne ne mene nn nnnn an nnnennnn 

// 

// DEFINE LOGICAL LINK 

//{R) LINK NAME (1-8 byte type-a string) 

//(R) DLC_NAME (1-8 byte ASCII string) 

// (The following names are supported by 
// Networking Services/2). 

// SDLC -SDLC 

// IBMTRNET - IBM Token-Ring Network 
// ETHERAND - ETHERAND Network 

// IBMPCNET - IBM PC Network 

I] X25DLC - X.25 

// TWINAX - Twinaxial 

//{R) ACTIVATE_AT_ STARTUP (see keywords) 

// YES 

// NO 

//{(R) CP_CP_SESSION SUPPORT (see keywords) 

// YES 

// NO 

/1{(1) ADAPTER_NUMBER (number between O & 255) 
//(0) ADJACENT NODE_TYPE (see keywords) 

// LEARN 

/] LEN 

// NN 

//(2) PREFERRED_NN SERVER (see keywords) 

// YES 

// NO 

//{3) DESTINATION ADDRESS (1-16 byte hex string) 

//{3) X25 DIRECTORY ENTRY (1-8 byte ASCII string) 

//{O) FQ _ADJACENT CP NAME (3-17 byte type-a string) 

/} (must be a fully-qualified (netid.name)) 
//(O) EFFECTIVE CAPACITY (number between O and 16000000 or 
// USE ADAPTER_DEFINITION) 

// USE ADAPTER_DEFINITION 

//KKO) COST_PER_BYTE (number between O and 255 or 
I USE ADAPTER_DEFINITION) 

// USE ADAPTER_DEFINITION | 

//{O) COST_PER_CONNECT_ TIME (number between 0 and 255 or 
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/I | USE_ADAPTER_DEFINITION) 
//  USE_ADAPTER_DEFINITION 


/1(0) PROPAGATION_DELAY (see keywords) 
// MINIMUM 
// LAN 


// TELEPHONE 

// PACKET SWITCHED NETWORK 
// SATELLITE 

// MAXIMUM 

ii USE ADAPTER_DEFINITION 
//(Q) SECURITY (see keywords) 
/} NONSECURE 

/} PUBLIC _ SWITCHED NETWORK 
/] UNDERGROUND CABLE 

// SECURE CONDUIT 

// GUARDED CONDUIT 

// ENCRYPTED 

// GUARDED_RADIATION 


//{(QO) USER_DEFINED_ 1 (number between O and 255 or 
// USE ADAPTER_DEFINITION) 

// USE ADAPTER_DEFINITION 

//(O) USER_DEFINED 2 (number between 0 and 255 or 
// USE ADAPTER_DEFINITION) 

// USE ADAPTER_DEFINITION 

//(Q) USER_DEFINED 3 (number between 0 and 255 or 
// USE _ADAPTER_DEFINITION) 

1} USE ADAPTER_DEFINITION 

//(O} LIMITED RESOURCE (see keywords) 

// YES 

// NO 

/} USE ADAPTER_DEFINITION 

/1/{Q) LINK_STATION ROLE (see keywords) 


// NEGOTIABLE 

// PRIMARY 

/I SECONDARY 

I} USE _ADAPTER_DEFINITION 


/K{4) SOLICIT SSCP_SESSION (see keywords) 

I} YES 

// NO 

//{O) DESCRIPTION (1-64 byte free format string) 

i] 

// Notes: 1) If DLC_NAME(X25DLC) is not specified, then ADAPTER_NUMBER must be 
// specified. If DLC_NAME(X25DLC) is specified, then ADAPTER_NUMBER 

// is ignored. 


// 
/] 2) Specify PREFERRED NN_SERVER(YES) only if 


ea ADJACENT NODE_TYPE(NN). You can specify PREFERRED NN_SERVER(YES) 
// only if CP_CP_ SESSION SUPPORT(YES) is specified. 

// 

// 3) DESTINATION ADDRESS and X25 DIRECTORY_ENTRY are mutually exclusive 
/} (if one is specified, the other cannot be specified). 

// If X25 DIRECTORY_ENTRY is specified, then DLC_NAME(X25DLC) must 

// be specified. If DESTINATION ADDRESS is specified, then 

// DLC NAME(X25DLC) must not be specified. 


// 
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// DESTINATION ADDRESS is required if a LAN DLC is specified. For 


// the LAN DLCs, the DESTINATION_ADDRESS must specify a valid 

/} LAN address (6 byte MAC address or a 6 byte MAC address appended 
// with a one byte SAP address). The names of the LAN DLCs are: 

// | 

// IBMTRNET - IBM Token-Ring Network 

// ETHERAND - ETHERAND Network 

// IBMPCNET - IBM PC Network 

// 

// Do not specify DESTINATION ADDRESS if one of the following names 
// is specified for DLC_NAME: 

// | 

// SDLC -SDLC 

// X25DLC - X.25 

// TWINAX - Twinaxial 

ji) 

// X25 DIRECTORY_ENTRY is required if DLC_NAME(X25DLC) is specified. 
// 

// 4) SOLICIT_SSCP_SESSION is always set to YES if the link is defined 

// as the host focal point link (DEFINE LOCAL CP HOST FP_LINK_ NAME). 
// 

// 5) CP_CP_SESSION SUPPORT is always set to NO if the adjacent node 
// is a LEN node (ADJACENT NODE_TYPE(LEN)). 

// 

// Defaults: ADJACENT NODE TYPE (LEARN) 

// PREFERRED _NN_SERVER (NO) 

// LIMITED RESOURCE (USE ADAPTER_DEFINITION) 

// (if CP_CP_ SESSION SUPPORT(NO) is specified) 

/] (NO) 

// (if CP_CP_SESSION_SUPPORT(YES) is specified) 

d} LINK_STATION ROLE (USE_ADAPTER_DEFINITION) 

// SOLICIT SSCP_SESSION (NO) 

// EFFECTIVE CAPACITY (USE _ADAPTER_DEFINITION) 

// COST PER_BYTE (USE _ADAPTER_DEFINITION) 

/} COST_PER_CONNECT_TIME (USE_ADAPTER_DEFINITION) 

// PROPAGATION DELAY (USE_ADAPTER_DEFINITION) 

// SECURITY (USE ADAPTER_DEFINITION) 

// USER_DEFINED_1 (USE _ADAPTER_DEFINITION) 

/} USER_DEFINED_ 2 (USE_ADAPTER_DEFINITION) 

// USER_DEFINED 3 (USE _ADAPTER_DEFINITION) 


if 

// Dynamic: YES 

i 

// Example: DEFINE LOGICAL LINK link_name(link’‘) 


// ADAPTER_NUMBER(1) 

// DLC_NAME(sdlc) 

// ACTIVATE_AT_STARTUP(NO) 

// CP_CP_SESSION SUPPORT(yes) 

// ADJACENT NODE_TYPE(nn) 

// preferred_nn_server(no) 

// DESTINATION ADDRESS(x’01’) 

// FQ ADJACENT CP_NAME(appn.neighbor) 
// effective capacity(4000000) 

// cost_per_byte(255) 

// cost_per_connect_time(use_adapter_definition) 
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/] propagation delay(lan) 


// security(NONSECURE) 

// user_defined 1(use_ adapter definition) 

/1 user_defined_2(use_adapter_definition) 

// user defined 3(use_adapter_ definition) 

// limited_resource(no) 

/1 link_station_role(secondary) 

// solicit_sscp_session(yes) 

// description(link to node neighbor); 

// 

| | wnnnnnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nn nnn nnn nnn nnnnnnnnennnnn 

| |----------------------------- DEFINE LOCAL LU -------------------------------- 
| | wnnvnnnnnnnnn nnn nnn nnn nn nnn nn nnn nn nn nnn nnn nnn nnn nnn nnn nnn nnn nnenann nnn ennen 

// 

// DEFINE LOCAL LU 

//(R) LULNAME (1-8 byte type-a string) 

//(O) LU_ ALIAS (1-8 byte ASCII string) 

//(Q) NAU_ADDRESS (number between 1 & 254 or INDEPENDENT LU) 
/] INDEPENDENT LU 

//{Q) DESCRIPTION (1-64 byte free format string) 

// 

// Notes: none 

// 

// Defaults: LU_ALIAS {same value as LU NAME) 

/} NAU_ ADDRESS (INDEPENDENT LU) 

// 

// Dynamic: YES 

if 

// Example: DEFINE LOCAL LU lu_name(filetran) 

// lu_alias(mylu) 

/} nau_address(independent_lu) 

/} description{Local LU for file transfer); 

// 

| | woe wn naan n-ne nn nn nn nnn nnn nnn nnn nnn nnn nnn nnn nnn nn nn nnn nnn nnn nn nnen neem eens 

|| ---------------------------- DEFINE PARTNER_LU ------------------------------- 
| | ponnnn nnn nnn nnn nnn nnn nnn nnn nn nnn nn nnn enn nn nn nnnn mann nnnnnn nn nenen= 

/} 

// DEFINE  PARTNER_LU 

/1(R) FQ PARTNER _LU NAME (1-17 byte type-a string) 

/} (can be fully-qualified (netid. name) 

// or a simple 8 character name (name)) 
//(Q) PARTNER_LU_ ALIAS {One or more aliases, separated by 
// commas (COMMA). Up to 256 aliases may 
/} be specified. Each alias is a 1-8 

// byte ASCII string) 


//(Q) PARTNER_LU_UNINTERPRETED_NAME (1-8 byte type-a string) 
/1(0) CONV_SECURITY_VERIFICATION (see keywords) 


/] YES 

// NO 

/1(Q) MAX_MC_LL_SEND_ SIZE (number between 2048 and 32767) 
/1/(Q) PARALLEL SESSION SUPPORT (see keywords) 

/1 YES 

/I NO 

/1{0) DESCRIPTION (1-64 byte free format string) 

/1 
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// Notes: none 


/} 

// Dynamic: YES 

// 7 | 

// Defaults: PARTNER_LU_ ALIAS (partner LU name (without the netid)) 
// CONV_SECURITY_VERIFICATION (NO) 

// MAX _MC_LL_ SEND _ SIZE (32767) 

i} PARALLEL SESSION SUPPORT (YES) 

// 

// Example: DEFINE PARTNER_LU fq_partner_lu_name(pipeline) 

i} partner_lu_alias(pipeline) 

// partner_lu_uninterpreted_name(piping) 

// conv_security_verification(no) | 

/} -max_mc_Il_send_size(4096) 

// parallel_session_support(yes) 

id description(Remote LU for pipeline); 

// 

// Example: DEFINE PARTNER_LU fq_partner_lu_name(pipeline) 

/I partner_lu_alias(pipeline, 

// piped, 

// pipes) 

7 partner_lu_uninterpreted_name(piping) 

// conv_security_verification(no) 

// max_mc_ll_send_size({4096) 

// parallel_session_support(yes) 

// description(Remote LU with multiple aliases); 
// , 

| | wnnnnnnnnnnnn nn nn nnn nn nnn nn nner nn nen nn enn nen eennnneneennnnnnnnenennnennnn 

| |------------------------ DEFINE _PARTNER_LU LOCATION -------------------------- 
| ae ee RN eee eee Oecd he SON a ne See OE re 

// 

// DEFINE _ PARTNER_LU_ LOCATION © 

//(R) FQ_OWNING CP NAME (3-17 byte type-a string) 

// (must be fully-qualified (netid.name)) 
//(O) WILDCARD_ENTRY (see keywords) 

// FULL | 

/} PARTIAL 

/] NO 

/1(1) FQ_PARTNER_LU NAME (1-17 byte type-a string) 

// (can be fully-qualified (netid.name) 

// or a simple 8 character name (name)) 
//(2) FQ.SERVING NN CP NAME (3-17 byte type-a string) 
// (must be fully-qualified (netid.name)) 
/1(3) LOCAL _NODE_NN_ SERVER (see keywords) 

// YES 

// NO 

//(O) DESCRIPTION (1-64 byte free format string) 

// 

// Notes: 1) FQ _PARTNER_LU_ NAME is required if WILDCARD ENTRY(NO) or 
// WILDCARD_ENTRY(PARTIAL). 

/} 2) Specify FQ. SERVING NN_CP_NAME only if WILDCARD_ENTRY(NO) 
// or WILDCARD_ENTRY(PARTIAL) 

// 3) This parameter is only referenced if the local node is a 
// network node (DEFINE LOCAL _CP NODE_TYPE(NN). If the local node 
/} is a network node, the following rules apply: 


204 Networking Services/2 


/ 


// a) If LOCAL_NODE_NN_SERVER(NO) is specified: 

// - FQ SERVING NN_CP_NAME must be specified. 

// - FQ SERVING NN_CP_ NAME must not be the same as the 
i} local cp name (DEFINE LOCAL CP FQ CP_NAME). 

// 

// b) If LOCAL NODE_NN_SERVER(YES) is specified: 

i - FQ SERVING NN _CP_NAME can be specified, but it must equal 
// the local cp name (DEFINE LOCAL _CP FQ _CP_ NAME). 

// 

// When defining LUs attached to your network node via a LEN 
// connection, you must still specify LOCAL_NODE_NN_SERVER(YES). 
I} This parameter is ignored if the local node is an end node. 
// 

// Defaults: WILDCARD ENTRY (NO) 

// LOCAL_NODE_ NN_SERVER(NO) 

// 

// Dynamic: YES 

// 

// Example: DEFINE PARTNER_LU_ LOCATION wildcard_entry(no) 

// fq_partner_lu_name(pipeline) ! 

// fq_owning cp_name(appn.neighbor) 

if local_node_nn_server(no) 

I} fq_serving_nn_cp_name(appn.nn) 

fi description(Location of pipeline LU); 

ji} 

| | wwnn nnn nena nnn nnn nnn nnn nnn nnn nn nnn nn nn nnn nn ene nner nnnnnncnnenenmnenennnnns 

| [ envnnnn nnn anne nnn anna nnn DEFINE COS ----------------n-n--n-nnennenenn= 

| | ewww nnn nw nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn enna nnn ne nnn nneennmnnnnnnnnnns 

// 

// DEFINE COS 

//(R) COS_NAME (1-8 byte type-a string) 

// (see note 1) 

//{R) TRANSMISSION PRIORITY (see keywords) 

// NETWORK 

Ds HIGH 

// MEDIUM 

// LOW 

//(R) NODE_ROW (see sub-parameters) 

// (more than one NODE_ROW parameter may 
// be specified). 

//(R) WEIGHT (number between 0 and 255) 

/1(R) CONGESTION RANGE (multi-valued parameter consisting of two 
// value keywords (see list below). If the 

// second value is NO, then the first value 

II must be NO) 

ih YES 

// NO 

//(R) ROUTE_ADDITION RES RANGE (multi-valued parameter consisting of 
i} two numbers between 0 and 255, with the 
// second number being greater than or 

// equal to the first number) 

/1({R) TG_ROW (see sub-parameters) 7 

ve (more than one TG ROW parameter may 
// be specified). | 
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//(R) WEIGHT (number between 0 and 255) 

//{R) COST _PER_BYTE RANGE {multi-valued parameter consisting of two 
/} numbers between 0 and 255, with the 

Hf second number being greater than or equal 

es to the first number) 

//(R) COST _PER_CONNECT_TIME_RANGE (multi-valued parameter consisting of two 
iy numbers between 0 and 255, with the 

Es second number being greater than or equal 

// to the first number) | 

//(R) EFFECTIVE_CAPACITY_ RANGE (multi-valued parameter consisting of two 
// numbers between O and 255, with the 

// second number being greater than or equal 

// to the first number) 

//{R) PROPAGATION DELAY RANGE (multi-valued parameter consisting of two 
// value keywords (see list below). The 

// second value can be the same as the first 

// value or any value appearing after the 

// first value in the list below) 

// MINIMUM 

// LAN 

H]/ TELEPHONE 

// PACKET SWITCHED NETWORK 

// SATELLITE 

// MAXIMUM 

//{R) SECURITY RANGE (multi-valued parameter consisting of two 

/| a value keywords (see list below). The 

// second value can be the same as the first 

// value or any value appearing after the 

// first value in the list below) 

// NONSECURE 

// PUBLIC SWITCHED NETWORK 

// UNDERGROUND CABLE 

// SECURE CONDUIT 

// GUARDED CONDUIT 

// ENCRYPTED 

// GUARDED_RADIATION 

/}{R) USER DEFINED 1 RANGE (multi-valued parameter consisting of two 
// numbers between 0 and 255, with the 

// second number being greater than or equal 

// to the first number) 

//(R) USER _DEFINED 2 RANGE (multi-valued parameter consisting of two 
if numbers between 0 and 255, with the 

// second number being greater than or equal 

fh to the first number) 

//{R) USER DEFINED 3 RANGE (multi-valued parameter consisting of two 
bp numbers between 0 and 255, with the 

// second number being greater than or equal 

y) to the first number) 

//(O) DESCRIPTION (1-64 byte free format string) 

// 

// Notes: 1) The IBM-supplied COS definitions are automatically created by the 

// configuration utilities. Therefore, these definitions cannot be 

// created using the DEFINE COS command. The names of the 

ji IBM-supplied COS definitions are: ECONNECT, #4INTER, #INTERSC, 

// #BATCH, #BATCHSC, CPSVCMG, and SNASVCMG. 
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// 
// Defaults: none 


// 

// Dynamic: YES 

// 

// Example: DEFINE COS cos_name(cos‘) 

// transmission_priority(network) 

// node_row (weight(101) 

// congestion_range(yes,yes) 

// route_addition_res_ range(11,21) 

// ) 

/} node_row (weight(102) 

// congestion_range(no,yes) 

/} route addition _res_range(12,22) 

// ) 

// node_row (weight(103) 

// congestion_range(no,no) 

// route_addition_res range(13,23) 

// ) 

// tg row (weight(201) 

// cost_per_byte_range(41,51) 

// cost_per_connect_time_range(21,31) 

// effective capacity_range(121,131) 

// propagation _delay_range(minimum,maximum) 
// security_range(NONSECURE,guarded_radiation) 
// user_defined 1_range(61,71) 

// user defined 2 range(81,91) 

// user _defined_3_range(101,111) 

/f ) 

/} tg row (weight(202) 

// | cost_per_byte_range(42,52) 

// cost_per_connect_time_range(22,32) 

// effective _capacity_range(122,132) 

// propagation delay: range(telephone, 

// PACKET SWITCHED NETWORK 
) 

// security_range(public_switched_network, 
// encrypted) 

// user defined 1 range(62,72) 

// user defined 2 range(82,92) 

// user_ defined 3 range(102,112) 

// ) 

/} tg row (weight(203) 

// cost_per_byte_range(43,53) 

// cost_per_connect_time_range(23,33) 

// | effective capacity _range(123,133) 

// propagation delay_range(telephone,telephone) 
// security_range(UNDERGROUND_ CABLE, 
Hf GUARDED_CONDUIT) 

/] user defined 1 range(63,73) 

// | user defined 2 range(83,93) 

// user defined 3 range(103,113) 

// ) 

// tg row (weight(204) 

// cost_per_byte_range(44,54) 
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/] cost_per_connect_time_range(24,34) 


// effective capacity _range(124,134) | 

/] propagation delay_range(telephone,telephone) | 
// security _range(SECURE_CONDUIT,SECURE CONDUIT) 
/] user_defined_1 range(64,74) | 
// user defined 2 range(84,94) 

// user defined 3 range(104,114) 

/} ) 

// description(Sample COS definition) 

// 

// 

| | nnnnnnnnnnnnnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nen ne nnn nen nn ennnenneeennnene 

| | nnnnennnn- nnn -- oon no-one DEFINE MODE ---------------------------------- 
ee 


/} 
// DEFINE_MODE 


//{R) MODE_NAME (1-8 byte type-a string or BLANK) 

// BLANK (see note 1) 

/1(2) MAX_RU_SIZE_ UPPER BOUND (number between 256 & 16384) 

/[1{O) COS NAME (1-8 byte type-a string) 

//(Q) DEFAULT RU_SIZE (see keywords) 

// YES 

// NO 

/1{(0) MAX_NEGOTIABLE SESSION LIMIT (number between 0 and 32767) 
//(Q) MIN_CONWINNERS_ SOURCE (number between 0 and 32767) 

//{Q) PLU_MODE_SESSION_LIMIT (number between 0 and 32767) 

//(Q) RECEIVE_ PACING WINDOW (number between O and 63) 

//{O) DESCRIPTION (1-64 byte free format string) 

/] 

// Notes: 1) The IBM-supplied mode definitions are automatically created by the 
// configuration utilities. These definitions can be superseded 

/} using the DEFINE MODE command, except for the CPSVCMG mode. 
// The names of the IBM-supplied mode definitions are: FCONNECT, 

// #INTER, #INTERSC, #BATCH, #BATCHSC, CPSVCMG, SNASVCMG, and 
// BLANK (the blank mode name). 


/] 

/1 2) MAX_RU_SIZE_UPPER_BOUND is required if DEFAULT _RU_SIZE(NO). 
/] 

/] 3) The value of MAX_NEGOTIABLE SESSION_LIMIT must be greater than 


/] or equal to the value of PLU MODE SESSION _LIMIT. 

// 

i} 3) The value of PLU_MODE_SESSION LIMIT must be greater than 

// or equal to the value of MIN CONWINNERS SOURCE. 

/} 

//! Defaults: COS_NAME(#CONNECT) 

/] DEFAULT RU_SIZE(YES) 

/1 RECEIVE PACING WINDOW(4) 

ies MAX_NEGOTIABLE SESSION_LIMIT(32767) 

// PLU_MODE_SESSION_LIMIT(32767 or MAX_NEGOTIABLE SESSION_ LIMIT 
// value, whichever is less) 

// MIN _CONWINNERS_SOURCE(1/2 of PLU_MODE_SESSION LIMIT value) 


// 

// Dynamic: YES 

// 

// Example: DEFINE MODE mode_name(mode') 
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/} max_ru_size_upper_bound(4096) 


// cos_name(#connect) 

/I default_ru_size(yes) 

// max_negotiable session _limit(1) 
// min _conwinners_source(1) 

/] plu_mode_session_limit(1) 

// receive pacing window(7) 

I} description(single session mode); 
/] 

| |onnnnennnnn anna nnn nn nnn nnn nn nnn nnn nnn nnn nnn nn nnn enn nena nnnmmmnnn nn 
| | nnnnnnn--n--- on === DEFINE DEFAULTS -------------------------------- 
| | n-nnnnnnnnnn nnn nn nn nn nnn nnn nn nnn nnn n nnn n nnn nnn con nen name nemannnnnnnnnnnannnn 
/] 


/] DEFINE DEFAULTS 
//(O) DEFAULT _TP_CONV_SECURITY_RQD (see keywords) 


// YES 
// NO 
//{Q) DEFAULT _TP_OPERATION (see keywords) 


// | QUEUED_OPERATOR_STARTED 

//  QUEUED OPERATOR PRELOADED 

//  QUEUED_AM_ STARTED 

// | NONQUEUED AM STARTED 

/(O) DEFAULT_TP_PROGRAM_TYPE (see keywords) 
// BACKGROUND 

//  FULL_SCREEN 

// PRESENTATION. MANAGER 

// VIO. WINDOWABLE 

//(O) DIRECTORY_FOR_INBOUND ATTACHES (1-64 byte ASCII string) 
//(O) IMPLICIT_INBOUND PLU SUPPORT (see keywords) 


// YES 

// NO 

//{Q) DEFAULT MODE NAME (1-8 byte type-a string or BLANK) 

// BLANK (see note ) 

//{(Q) DEFAULT LOCAL LU ALIAS (1-8 byte ASCII string) 

//(Q) MAX_HELD ALERTS (number between 0 & 255) 

//(Q) MAX_MC_LL_ SEND_SIZE (number between 2048 and 3276/7) 
//(O) DESCRIPTION (1-64 byte free format string) 

vy), 

// Notes: 1) DIRECTORY _FOR_INBOUND_ ATTACHES uses the special value (*) 
/] to indicate that the system PATH statement should be used 

/} when starting an undefined transaction program. This value 

/I does NOT change if you change the value of the ASTERISK 

/} delimiter. 

// 2) The CPSVCMG mode cannot be used for user sessions, therefore 
/} CPSVCMG cannot be specified for DEFAULT MODE_NAME. 

I} 

// Defaults: DEFAULT _TP_OPERATION{(NONQUEVED_AM_STARTED) 

af DEFAULT TP_PROGRAM_TYPE(BACKGROUND) 

// DEFAULT _TP_CONV_ SECURITY ROQD(NO) 

/} DEFAULT LOCAL LU ALIAS(the local cp becomes the default LU) 
// IMPLICIT INBOUND _PLU_SUPPORT(YES) 

// MAX_HELD_ALERTS(10) 

// MAX MC_LL_SEND_SIZE(32767) 

/} 


// Dynamic: NO 
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/} 
// Example: DEFINE DEFAULTS default_tp_conv_security_rqd(no) 


// default_tp_operation{queued_am_started) 

/} default_tp_program_type(vio_windowable) 

// directory_for_inbound_attaches(c:\cmlib\appn) 
ii implicit_inbound_plu_support({yes) © 

/} default_mode_name(mode’1) 

// default_local_lu_alias(locallu) 

// max_held_alerts(15) 

/} max_mc_ll_ send_size(2048) 

// description(Default node properties for node home); 
// 

| | wnennnnnn nnn nn nnn nnn nnn nnn nnen nnn enema nennenennennnnenennnnneenenen 

| | wnnnnnnnna nn nnn nnn nnn nnn nne nnn DEFINE_TP ----------------------------------- 

| | onnnnnnnnnnnnnnnnnnnnnnn anne enn anne nnn n nnn n nnn nen en ennennneennnneennencnnnnas 

// 

// DEFINE _TP 

/1(1) TP_NAME (1-64 byte type-ae string) 

//(1) SNA_SERVICE_TP_NAME {multi-valued parameter consisting 
// of a one byte hex number with a value 
// between x’00’ and x’3F’ (excluding 

// x’OE’ and x’OF’), and a 1-3 byte char 
/} type-a string with no restriction on 

/} the first digit) 

/} or 

// (a one byte hex number with a value 
// between x’00’ and x’3F’ (excluding 

// x’OE’ and x’0F’)) 

//{R) FILESPEC (1-80 byte ASCII string) 

//{Q) ICON_FILESPEC (1-80 byte ASCII string) 

//(0) PARM_STRING (1-128 byte ASCII string) 

//(Q0) CONV_SECURITY RQD (see keywords) 

/} YES 

// NO 

/1/(Q) CONVERSATION_TYPE (see keywords) 

// BASIC 

// MAPPED 

if EITHER 


/1{2) INCOMING ALLOCATE QUEUE DEPTH (number between 1 & 255) 

/1{3) INCOMING ALLOCATE_TIMEOUT (number between 0 & 32767 or INFINITE) 
/1 INFINITE 

//{O0) PROGRAM_TYPE (see keywords) 

// BACKGROUND 

/} FULL_SCREEN 

// PRESENTATION MANAGER 

// VIO_WINDOWABLE 

//(Q) RECEIVE _ALLOCATE_TIMEOUT (number between 0 & 32767 or INFINITE) 
// INFINITE 


//{O) SYNC_LEVEL (see keywords) 
/} NONE 

// CONFIRM 

/} EITHER , 
//{Q) TP_OPERATION (see keywords) 


/1 QUEUED_OPERATOR_STARTED 
/] QUEUED_OPERATOR_PRELOADED 
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// 
/I 
// 
// 


QUEUED AM STARTED 
NONQUEUED AM_STARTED 
(1-64 byte free format string) 


(QO) DESCRIPTION 


// Notes: 1) TP_NAME and SNA_SERVICE_TP_NAME are mutually exclusive 


/| 


(if one is specified, the other cannot be specified), but one 


(either TP_NAME or SNA_SERVICE_TP_NAME) must be specified. 
2) Specify INCOMING ALLOCATE QUEUE_DEPTH only if 


TP_OPERATION(NONQUEVED_ AM_STARTED) is not specified. 


3) Specify INCOMING ALLOCATE TIMEOUT only if 


TP_OPERATION{NONQUEUED_AM_STARTED) is not specified. 


/] Defaults: CONV_SECURITY_RQD(NO) 

CONVERSATION_TYPE(EITHER) 
INCOMING ALLOCATE QUEUE _DEPTH(255) (ignored if TP_OPERATION is 
NONQUEUED_AM_ STARTED) 
INCOMING ALLOCATE _TIMEOUT(INFINITE) (ignored if TP_OPERATION is 


// 
/] 
/I 
/| 
/I 
/1 
/1 
// 
// 
// 
// 
// 


QUEVED_OPERATOR_PRELOADED) 


PROGRAM_TYPE(BACKGROUND) 
RECEIVE ALLOCATE_TIMEOUT(INFINITE) 
SYNC_LEVEL(EITHER) 
TP_OPERATION{(NONQUEUED_AM_STARTED) 


Dynamic: YES 


// Example: DEFINE_TP tp_name(home$program) 
filespec{c:\cmlib\nome.exe) 
icon_filespec(c:\cmlib\home.ico) 
parm_string{/hello /goodbye) 
conv_security_rqd(no) 
conversation _type(mapped) 
incoming _allocate_queue_depth(20) 
incoming allocate_timeout(100) 
program_type(presentation_manager) 
receive_allocate_timeout(200) 
sync_level(confirm) 
tp_operation(queued_operator_started) 
description(Define the home transaction program); 


/I 
// 
// 
// 
/] 
/I 
/1 
// 
// 
// 
/} 
/} 
// 
/] 
gs 
// 
// 
// 
// 
/I 
// 
/I 
// 
// 
/} 
/} 
If 


DEFINE TP sna_service tp_name(X’06’,1) 
filespec(c:\cmlib\svctp.exe) 
icon_filespec(c:\cmlib\svctp.ico) 
parm_string(/hello /goodbye) 
conv_security_rqd(no) 
conversation_type(either) 
incoming allocate _queue_depth({20) 
incoming allocate_timeout(100) 
program_type(presentation_manager) 
receive _allocate_timeout(200) 
sync_level{either) 
tp_operation(queued_operator_started) 
description(Define the SNA service tp x’06F1’); 
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/] 
// DEFINE_CPIC_SIDE_INFO | 
//(R) SYMBOLIC_DESTINATION NAME (1-8 byte char set 01134 string) 


//(1) PARTNER_LU_ ALIAS (1-8 byte ASCII string) 

//(1) FQ_PARTNER_LU NAME (1-17 byte char set 01134 string) 

// {can be fully-qualified (netid.name) 

// or a simple 8 character name (name)) 

//(2) TP_NAME (1-64 byte char set 00640 string) 

//{2) SNA_SERVICE_TP_NAME (multi-valued parameter consisting 
// of a one byte hex number with a value — 

/} between x’00’ and x’3F’ (excluding 

// x’OE’ and x’0F’), and a 1-3 byte char 

/} set 01134 string with no restriction 

// on the first digit) 

// or | 

// (a one byte hex number with a value 

// between x’00’ and x’3F’ (excluding 

// x’OE’ and x’OF’)) 7 

//{R) MODE_NAME (1-8 byte char set 01134 string or BLANK) 
// BLANK (see note 3) . | 
//{O) DESCRIPTION (1-64 byte free format string) 

/} 

// Notes: 1) PARTNER_LU_ ALIAS and FQ PARTNER_LU NAME are mutually exclusive 
// (if one is specified, the other cannot be specified), but one 

// (either PARTNER_LU_ ALIAS or FQ _PARTNER_LU NAME) must be specified. 
// 2) TP_NAME and SNA_SERVICE_TP_NAME are mutually exclusive 
// (if one is specified, the other cannot be specified), but one 

I} (either TP_NAME or SNA _ SERVICE_TP_NAME) must be specified. 
/} 3) The CPSVCMG mode cannot be used for user sessions, therefore 
// CPSVCMG cannot be specified for MODE NAME. 

// 7 

// Defaults: none 

// 

// Dynamic: YES 

// 

// Example: DEFINE _CPIC_SIDE_INFO symbolic_destination_name(cpic) 

// partner_lu_alias(pipeline) 

// mode_name(mode') 

/1 sna_service tp_name(x’3C’,sna); 

// 

| | -nnnw nnn nn nnnn nn nnn nnn nnn nnn nnn nnn nn nnn nnn nnn nnn nnn nnn nnn nnen nn nennnn 

| [ennnnnnnnnnnn nn nena nnn START_ATTACH MANAGER ------------------------------ 

| [onencnnnnn nn enn anne nnn nnn nnnnnn nena nnn nnn enna enema enn nan nomen ennem nn 

/} 

// START_ATTACH_ MANAGER 

// 

// Notes: 1) START_ATTACH_ MANAGER has no parameters. 

/} 

// Defaults: none 

// 

// Dynamic: NO 

/} 

// Example: START_ATTACH MANAGER; 

// 
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// 

// ACTIVATE_LOGICAL_LINKS 

//(R) LINK NAME (1-8 byte type-a string) 
/] 

// Defaults: none 

I} 

// Dynamic: NO 

// 

// Example: ACTIVATE LOGICAL LINKS link_name(link’‘); 
/} 


| | wnwnnnennnnnn enna nn nnnnnn nnn nnn nnn nnn nnn n nee nnn nnn en nen nn en nnn naennen enna 

| | nnnnnnnnnannnnnn nnn nn nnn nnn nnn nnn CNOS ---------------- enna nnn nee n nen ene nen 
le 

// 

// CNOS 

/1{(O) LOCAL LU ALIAS (1-8 byte ASCII string) 

/1{(1) PARTNER_LU_ ALIAS (1-8 byte ASCII string) 

/1(1) FQ. PARTNER_LU NAME (1-17 byte type-a string) 

/} (can be fully-qualified (netid. name) 

// or a simple 8 character name (name)) 

/1/(2) MODE_NAME (1-8 byte type-a string or BLANK) 

// {see note 3 about restrictions on the 

/] mode names and other parameters) 

/] BLANK 

//(R) SET NEGOTIABLE (see keywords) 

// YES 

/} NO 

/1{5) AUTO_ACTIVATE (number between 0 and 32767) 

//(Q) PLU-MODE_SESSION_ LIMIT (number between 0 and 32767) 

/] (see note 4) 

/1{(Q) MIN_CONWINNERS_ SOURCE (number between 0 and 32767) 
// (see note 4) 

/1/(0) MIN_CONWINNERS_ TARGET (number between 0 and 32767) 
/] (see note 4) 

//(6) RESPONSIBLE (see keywords) 

// SOURCE 

// TARGET 

//{6) DRAIN SOURCE (see keywords) 

/] YES 

// NO 

//{6) DRAIN_ TARGET (see keywords) 

// YES 

// NO 

// 

// Notes: 1) PARTNER_LU_ ALIAS and FQ PARTNER_LU_ NAME are mutually exclusive 
i} (if one is specified, the other cannot be specified), but one 

/I (either PARTNER_LU_ ALIAS or FQ PARTNER_LU NAME) must be specified. 
// 2) MODE_NAME is required if PLU MODE_SESSION LIMIT > 0. If 
// PLU MODE_SESSION_LIMIT = 0, MODE_NAME is optional. 

// 3) When MODE_NAME(SNASVCMG), the settings for PLU_MODE_SESSION_LIMIT, 
// MIN CONWINNERS_SOURCE, and MIN_CONWINNERS_TARGET are limited to 
// the following combinations: 
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// allowed combinations 


i (a) (b) — (¢) 

// PLU MODE SESSION _ LIMIT 2 1 0 

/} MIN _CONWINNERS SOURCE 1 0 0 

// MIN _CONWINNERS_ TARGET 1 1 0 

/] 

// The session limits of the CPSVCMG mode cannot be changed by a 

/] user command, therefore CPSVCMG cannot be specified for MODE_NAME. 
/} 

If 4) PLU_MODE SESSION _LIMIT must be greater than the sum of 

// MIN _CONWINNERS_ SOURCE and MIN _CONWINNERS_ TARGET 


Hf 9) Specify AUTO_ACTIVATE only if PLU_MODE_SESSION_LIMIT > 0 
// 6) Specify RESPONSIBLE, DRAIN _SOURCE, and DRAIN_TARGET only if 


// PLU _MODE_ SESSION _LIMIT(O) and MODE_NAME is not SNASVCMG. 
// RESPONSIBLE, DRAIN SOURCE, and DRAIN_TARGET are required if 
/1 PLU MODE_SESSION_LIMIT(O) and MODE_NAME is not SNASVCMG. 
// 
// Defaults: PLU_MODE_SESSION_LIMIT(32767) 
// MIN _CONWINNERS_ SOURCE(O) 
/} MIN _CONWINNERS_TARGET(Q) 
// AUTO_ACTIVATE(O) (ignored if PLU MODE SESSION _LIMIT(O)) 
// 
// Dynamic: NO 
/} 
// Example: CNOS local_lu_alias(home) 
/} fq_partner_lu_name(appn.neighbor) 
/} mode _ name(mode2) 
If set_negotiable(no) 
I} plu_mode_session_limit(4) 
// min _conwinners_source(2) 
// min_conwinners _target(2) 
/} auto_activate(2); 
/] 
| | wnnnnnnnnn nnn nnn nn nnn nn nnn nn nnn nnn nnn nnn nnn nnn nnn nnn nnn nenennnannnn 
| | wnnnnnnnn nnn nnn nnn nnn nnn nn nnn nn nnn nnn nnn nnn nnn nnn nnn enn nena 
| | -n------------------------- DELIMITER SETTINGS ------------------------------- 
| | wonnnnnnn nnn onan nnn n nnn n nnn nnn e nn nnn nnn enna n nnn enn enema en nnme nena 
| | oennn nn nnn nnn nnn nnn nnn nnn nnn nnn nner nn nnn nn nn nnn n enna nen ennnnnren enna 
// 
// Left parenthesis (LPAREN) delimiter 
/I | 
// |Right parenthesis (RPAREN) delimiter 
/1 || 
// ||Comma (COMMA) delimiter 
// ||| 
// |||{Semicolon (SEMI) delimiter 
/ \{II 
// |\|{Forward slash (SLASH) delimiter 
/? iT 
// \\|||Asterisk (ASTERISK) delimiter 
7 HT 
// |\\|||Single quotation mark (QUOTE) delimiter 
7 | 
a 0 // Delimeter values 
// 
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/} 

// Following is each command name, parameter name, and value keyword along with 
// their associated internal ids. You can change the command names, parameter 

// names, and value keywords by changing the text in this file. To change a 

// name, find the name in this section and enter your new name, leaving the 

// internal id unchanged. NEVER change the internal id values. Back up this 

// file before making any changes in case you accidentally delete an entry or 

// alter an internal id. After this file has been changed, the node definitions 

// files will be interpreted using the new command names, parameter names, 

// and value keywords. The command names, parameter names, and value keywords 
// are sometimes referred to collectively as keywords. 


/} 

| | onnnnnnnnnnnnnn nnn nnn nnn nnn nnn nnn nnn nnn nnnn nn nnn nnen enema nnennnnnennnnnnnne 

| | onnnne n-ne nnn COMMAND NAMES -------------------------------- 

| | nnnnnnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn nnn cnn nnn nnn enna enna nnn mann 

i} 

// Commands (arranged alphabetically): 

// 

ACTIVATE _LOGICAL LINKS 167 // Literal: ACTIVATE LOGICAL LINKS 
CNOS 168 // Literal: CNOS 

DEFINE CPIC SIDE INFO 174 // Literal: DEFINE CPIC_SIDE_INFO 
DEFINE CONNECTION NETWORK 155 // Literal: DEFINE CONNECTION NETWORK 
DEFINE COS 162 // Literal: DEFINE COS 

DEFINE DEFAULTS 164 // Literal: DEFINE DEFAULTS 

DEFINE LOCAL _CP 154 // Literal: DEFINE LOCAL _CP 

DEFINE LOCAL LU 158 // Literal: DEFINE LOCAL LU 

DEFINE LOGICAL LINK 157 // Literal: DEFINE LOGICAL LINK 

DEFINE LU LU PASSWORD 159 // Literal: DEFINE LU LU PASSWORD 
DEFINE MODE 163 // Literal: DEFINE MODE 

DEFINE PARTNER_LU 160 // Literal: DEFINE PARTNER_LU 

DEFINE PARTNER_LU_ LOCATION 161 // Literal: DEFINE PARTNER_LU_ LOCATION 
DEFINE TP 165 // Literal: DEFINE TP 

DEFINE USER_ID_ PASSWORD 156 // Literal: DEFINE USER_ID PASSWORD 
START ATTACH MANAGER 166 // Literal: START ATTACH MANAGER 
/} 

| | nnnnnnnnnnnnnnnn nnn nnn nnn nner nn nnn wenn nnn nen nnn nn nnn nnnnn enon nenenanenneneen 

| | -nnnnen~nnnnnnnn nnn PARAMETER NAMES -------------------------------- 

| | nnnmnnnnnnnnnen nnn nnn nnn nnn nn nnn nn nnn nnn n nnn nnn mene nnn n nn en nnn nnn enn 

ii. 

// Parameters (arranged alphabetically): 

// | 

SOLICIT SSCP_SESSION 130 // Literal: SOLICIT SSCP_SESSION 
ACTIVATE_AT_STARTUP 80 // Literal: ACTIVATE_AT_ STARTUP 
ADAPTER_INFO 35 // Literal: ADAPTER_INFO 
ADAPTER_NUMBER 9 // Literal: ADAPTER NUMBER 

ADJACENT NODE TYPE 47 // Literal: ADJACENT NODE_TYPE 
AUTO_ ACTIVATE 50 // Literal: AUTO ACTIVATE 

CP_ALIAS 19 // Literal: CP_ALIAS 

CONGESTION RANGE 66 // Literal: CONGESTION RANGE 


CONV_SECURITY_RQD 87 // Literal: CONV_SECURITY_RQD 
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CONV_SECURITY_VERIFICATION 59 // Literal: CONV_SECURITY_ VERIFICATION 


CONVERSATION. TYPE 86 // Literal: CONVERSATION_TYPE 

COS NAME 14 // Literal: COS_NAME 

COST PER BYTE 2 // Literal: COST PER BYTE 

COST PER BYTE RANGE 70 // Literal: COST_PER_BYTE_RANGE 

COST PER CONNECT TIME 4 // Literal: COST PER_CONNECT_TIME 
COST PER CONNECT TIME RANGE _ 69 // Literal: COST PER CONNECT TIME RANGE 
CP_CP_SESSION_ SUPPORT 49 // Literal: CP_CP_SESSION SUPPORT 
DEFAULT LOCAL LU ALIAS 177 // Literal: DEFAULT LOCAL LU ALIAS 
DEFAULT MODE NAME 38 // Literal: DEFAULT MODE_NAME 

DEFAULT RU_SIZE 76 // Literal: DEFAULT _RU_SIZE 

DEFAULT TP_CONV_SECURITY RQD 43 // Literal: DEFAULT _TP_CONV_SECURITY_RQD 
DEFAULT TP_OPERATION 41 // Literal: DEFAULT _TP_OPERATION 
DEFAULT_TP_PROGRAM_TYPE 42 // Literal: DEFAULT _TP_PROGRAM_TYPE 
DESCRIPTION 173 // Literal: DESCRIPTION 

DESTINATION ADDRESS 48 // Literal: DESTINATION ADDRESS 
DIRECTORY_FOR_INBOUND ATTACHES 40 // Literal: DIRECTORY _FOR_INBOUND ATTACHES 
DLC_NAME 8 // Literal: DLC_NAME 

DRAIN SOURCE 101 // Literal: DRAIN SOURCE 

DRAIN TARGET 102 // Literal: DRAIN. TARGET 
EFFECTIVE_CAPACITY 34 // Literal: EFFECTIVE_CAPACITY 

EFFECTIVE CAPACITY RANGE 68 // Literal: EFFECTIVE _CAPACITY_RANGE 
FILESPEC 84 // Literal: FILESPEC 

FQ ADJACENT CP_NAME 46 // Literal: FQ.ADJACENT_CP_NAME 

FQ CN NAME 33 // Literal: FQ.CN NAME 

FQ _CP_NAME 18 // Literal: FQ.CP_NAME 

FQ OWNING CP_NAME 61 // Literal: FQ.OWNING _CP_NAME 

FQ PARTNER_LU_NAME 12 // Literal: FQ. PARTNER_LU_NAME 

FQ SERVING NN _CP_NAME 62 // Literal: FQ. SERVING NN _CP_NAME 
HOST _FP_LINK_NAME 27 // Literal: HOST _LINK_NAME 

HOST FP SUPPORT 28 // Literal: HOST_FP_SUPPORT 
ICON_FILESPEC 45 // Literal: ICON FILESPEC 


IMPLICIT INBOUND_PLU_SUPPORT 39 // Literal: IMPLICIT_INBOUND_PLU_ SUPPORT 
INCOMING ALLOCATE_QUEUE DEPTH 91 // Literal: INCOMING ALLOCATE _QUEUE_DEPTH 


INCOMING ALLOCATE_TIMEOUT 92 // Literal: INCOMING ALLOCATE_TIMEOUT 
LIMITED RESOURCE 51 // Literal: LIMITED RESOURCE 

LINK_NAME 11 // Literal: LINK _NAME 

LINK_STATION ROLE 52 // Literal: LINK STATION ROLE 

LOCAL _LU_ALIAS 94 // Literal: LOCAL_LU_ ALIAS 

LOCAL _NODE_NN_ SERVER 99 // Literal: LOCAL_NODE_NN SERVER 

LU ALIAS 54 // Literal: LU_ALIAS 

LU NAME 53 // Literal: LU_-NAME 

MAX_HELD_ALERTS 44 // Literal: MAX_HELD_ALERTS 
MAX_MC_LL_SEND_SIZE 10 // Literal: MAX_MC_LL_SEND_SIZE 
MAX_NEGOTIABLE SESSION LIMIT 79 // Literal: MAX_NEGOTIABLE_SESSION_LIMIT 
MAX_RU_SIZE UPPER_BOUND 77 // Literal: MAX_RU_SIZE_UPPER_BOUND 
MIN _CONWINNERS_SOURCE 97 // Literal: MIN CONWINNERS_SOURCE 
MIN _CONWINNERS_TARGET 98 // Literal: MIN CONWINNERS_TARGET 
MODE_NAME 16 // Literal: MODE_NAME 

NAU_ADDRESS 20 // Literal: NAU_ ADDRESS 

NODE_ID 22 // Literal: NODE_ID 

NODE ROW 64 // Literal: NODE_ROW 

NODE_TYPE 21 // Literal: NODE_TYPE 

PARALLEL_SESSION SUPPORT 58 // Literal: PARALLEL_SESSION SUPPORT 
PARM_STRING 85 // Literal: PARM_STRING 
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PARTNER _LU_ALIAS 43 // Literal: PARTNER _LU_ALIAS 
PARTNER LU UNINTERPRETED NAME 57 // Literal: PARTNER_LU_UNINTERPRETED_NAME 


PASSWORD 37 // Literal: PASSWORD 
PLU_MODE_SESSION_LIMIT 17 // Literal: PLU_MODE_SESSION_LIMIT 
PREFERRED NN SERVER 56 // Literal: PREFERRED NN SERVER 
PROGRAM_TYPE 90 // Literal: PROGRAM_TYPE 

PROPAGATION. DELAY 4 // Literal: PROPAGATION DELAY 
PROPAGATION DELAY RANGE 72 // Literal: PROPAGATION DELAY RANGE 
RECEIVE ALLOCATE TIMEOUT 93 // Literal: RECEIVE ALLOCATE_TIMEOUT 
RECEIVE PACING WINDOW 78 // Literal: RECEIVE. PACING WINDOW 
RESPONSIBLE 100 // Literal: RESPONSIBLE 

ROUTE_ADDITION RES RANGE 65 // Literal: ROUTE_ADDITION RES_ RANGE 
SECURITY 3 // Literal: SECURITY 

SECURITY_RANGE 71 // Literal: SECURITY_RANGE 

SET NEGOTIABLE 95 // Literal: SET NEGOTIABLE 

SNA SERVICE _TP_NAME 176 // Literal: SNA_SERVICE TP NAME 
SYMBOLIC DESTINATION. NAME 175 // Literal: SYMBOLIC_DESTINATION_ NAME 
SYNC_LEVEL 88 // Literal: SYNC_LEVEL 

TG_ROW 67 // Literal: TS ROW 

TP_NAME 81 // Literal: TP. NAME 

TP OPERATION 89 // Literal: TP_OPERATION 

TRANSMISSION PRIORITY 63 // Literal: TRANSMISSION. PRIORITY 
USER_DEFINED 1 5 // Literal: USER DEFINED 1 

USER DEFINED 2 6 // Literal: USER DEFINED 2 

USER DEFINED 3 7 // Literal: USER DEFINED 3 

USER DEFINED 1 RANGE 73 // Literal: USER_DEFINED_1_ RANGE 

USER DEFINED 2 RANGE 74 // Literal: USER_DEFINED 2 RANGE 
USER_DEFINED 3 RANGE 75 // Literal: USER_DEFINED 3 RANGE 
USER_ID 36 // Literal: USER_ID 

WEIGHT 15 // Literal: WEIGHT 

WILDCARD_ ENTRY 60 // Literal: WILDCARD_ENTRY 

X25 DIRECTORY_ENTRY 55 // Literal: X25 DIRECTORY ENTRY 

/] 

fg cl ed eealas aaa acta 

| eer VALUE KEYWORDS scxteceeeecss eects 


// 
// Value keywords (arranged alphabetically): 
/] 


BACKGROUND 125 // Literal: BACKGROUND 

BASIC 144 // Literal: BASIC 

BLANK 141 // Literal: BLANK 

CONFIRM 148 // Literal: CONFIRM 

EITHER 146 // Literal: EITHER 

EN 103 // Literal: EN 

ENCRYPTED 115 // Literal: ENCRYPTED 

FULL 172 // Literal: FULL 

FULL_SCREEN 126 // Literal: FULL_SCREEN 
GUARDED_CONDUIT 114 // Literal: GUARDED CONDUIT 
GUARDED_RADIATION 116 // Literal: GUARDED_RADIATION 
HIGH 138 // Literal: HIGH 

INDEPENDENT _LU 109 // Literal: INDEPENDENT _LU 
INFINITE 149 // Literal: INFINITE 

LAN 119 // Literal: LAN 

LEARN 129 // Literal: LEARN 
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LEN 


131 // Literal: LEN 


LOCALLY 142 // Literal: LOCALLY ~ 
LOW 140 // Literal: LOW 

MAPPED 145 // Literal: MAPPED 
MAXIMUM 120 // Literal: MAXIMUM 
MEDIUM 139 // Literal: MEDIUM 
NONSECURE 171 // Literal: NONSECURE 
MINIMUM 110 // Literal: MINIMUM 
NEGOTIABLE 133 // Literal: NEGOTIABLE 
NETWORK 137 // Literal: NETWORK 
NN 104 // Literal: NN 

NO 108 // Literal: NO 

NONE 147 // Literal: NONE 


NONQUEUED_AM_ STARTED 
PACKET _SWITCHED_NETWORK 


124 // Literal: NONQUEUED AM_STARTED 
118 // Literal: PACKET SWITCHED NETWORK 


PARTIAL 136 // Literal: PARTIAL 
PRESENTATION MANAGER 127 // Literal: PRESENTATION MANAGER 
PRIMARY 134 // Literal: PRIMARY 


PUBLIC_SWITCHED_ NETWORK 
QUEUED_AM_STARTED 

QUEUED OPERATOR STARTED 
QUEUED_OPERATOR_PRELOADED 


111 // Literal: PUBLIC_SWITCHED_NETWORK 
123 // Literal: QUEUED_AM STARTED 
121 // Literal: QUEUED_ OPERATOR_STARTED 
122 // Literal: QUEUED_OPERATOR_PRELOADED 


REMOTELY 143 // Literal: REMOTELY | 
SATELLITE 170 // Literal: SATELLITE 

SECONDARY 135 // Literal: SECONDARY 

SECURE_CONDUIT 113 // Literal: SECURE_CONDUIT 

SOURCE 152 // Literal: SOURCE 

TARGET 153 // Literal: TARGET 

TELEPHONE 117 // Literal: TELEPHONE 


UNDERGROUND_CABLE 
USE_ADAPTER_DEFINITION 
VIO_WINDOWABLE 


112 // Literal: UNDERGROUND_CABLE 
132 // Literal: USE_ADAPTER_DEFINITION 
128 // Literal: VIO_.WINDOWABLE 


YES 107 // Literal: YES 

// 

| [wnnnnnnnnnnnn nnn nnn nnn nnn nnn n nnn nnn nnnn nnn nnn n nnn nen nce e nena nnn eeenennnneen 

|} ----------------~---- RESERVED KEYWORDS (for future use) --------------------- 
Telnet cea tcc nen ea te mat dk orig alae aay 

// 

RESERVED23 23 // Literal: RESERVERD23 
RESERVED24 24 // Literal: RESERVERD24 
RESERVED25 25 // Literal: RESERVERD25 
RESERVED26 26 // Literal: RESERVERD26 
RESERVED29 29 // Literal: RESERVERD29 
RESERVED30 30 // Literal: RESERVERD30 
RESERVED31 31 // Literal: RESERVERD31 
RESERVED32 32 // Literal: RESERVERD32 
RESERVED82 82 // Literal: RESERVERD82 
RESERVED83 83 // Literal: RESERVERD83 
RESERVED96 96 // Literal: RESERVERD96 
RESERVED105 105 // Literal: RESERVERD105 
RESERVED106 106 // Literal: RESERVERD106 
RESERVED150 150 // Literal: RESERVERD150 
RESERVED151 151 // Literal: RESERVERD151 
RESERVED169 169 // Literal: RESERVERD169 
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Appendix B. What PMDSPLAY Shows 


This appendix shows an example of what can be displayed using the Display 
Active Configuration (PMDSPLAY) window. 


The configuration used is: 


DOMAIN USIBMRA 


EN NN NN 
CLAUDLU1 
CLAUDLU2 HENRILU1 RALYOS2A 


There are three conversations ({requester/server): 
1. CLAUDLU1 - HENRILU1 

2. CLAUDLU1 - RALYOS2A 

3. RALYOS2A - HENRILU1. 


Here is what can be displayed with the Display Active Configuration 
(PMDSPLAY) window on the HENRILU1 workstation. 


B.1 APPC 


Adapter Information 


KEKEEKRKEKEKRKEEREREREREREEEEREREKREREREKREERE 


* Adapter Information * 
KKEEKKREKREREREKREREREKRKERKEREKREREKREKREREKEEKRES 
Number of adapters 2 
1>DLC name IBMTRNET 
Adapter number 0 
Link station role Negotiable 
Line type Switched 
Limited resource No 
Limited resource timeout 30 
Max frame data (BTU) size 1033 
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o> 


Receive window 

Send window 

Maximum link stations 
Asynchronous balanced mode 
Effective capacity 

Cost per connect time 
Cost per byte 
Propagation delay 

User defined parameter 1 
User defined parameter 2 
User defined parameter 3 
Security 


DLC name 

Adapter number 

Link station role 

Line type 

Limited resource 

Limited resource timeout 
Max frame data (BTU) size 
Receive window 

Send window 

Maximum link stations 
Asynchronous balanced mode 
Effective capacity 

Cost per connect time 
Cost per byte 

Propagation delay 

User defined parameter 1 
User defined parameter 2 
User defined parameter 3 
Security 


SNA Global Information 


KKEKEEKEKKEREERERKEEREKREREKKREREREKREREEERE 


* 


SNA Global Information 


* 


KKEKRKEEEKEEREREREREKREKRERERRERKREEKREREKKSE 


Ne 
Co 


twork name 
ntrol point (CP) name 


Physical unit (PU) name 


No 
CP 
No 


de ID (for XID) 
alias 
de type 


CP local address 


Wo 
Ma 
Ma 


Communications Manager version 
Networking Services/2 version 


rkstation serial number 
chine type 
chine model number 


Link Definition Information 


KKEKEKREREERREREEREREEEKRERERERREEEKRERERESR 
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* 


Link Definition Information 


* 


KEEKREEEEREEREERERERERERRREREKRERERERER 


Nu 


mber of links 


1>Link name 


Networking Services/2 


Adjacent node CP name 


1 

2 

10 

Yes 

4000000 bits per second 
8) . 

0 

384.00 microseconds (local area network) 
128 

128 

128 

Nonsecure 


TBMTRNET 

1 

Negotiable 

Switched 

Yes 

30 

1033 

1 

2 

4 

Yes 

4000000 bits per second 
0 

0 

384.00 microseconds (local area network) 
128 

128 

128 

Nonsecure 


USIBMRA 

HENRILUI 

HENRILUI 

X'Q5D22221' 

HENRILUI 

Network node 

Not used (independent LU) 
00-0000000 

8570 


1.0.0000 


2 


RAKSA20 
USIBMRA. RAK 


Adjacent node type LEN 


DLC name IBMTRNET 
Adapter number 0 | 
Destination DLC address X'40000124000004 ' 
CP-CP session support No 
Preferred NN server No 
Auto-activate link Yes 
Transmission group number 0 
Limited resource No 
Solicit SSCP session Yes 
Init self No 
BIND support Yes 
Link station role Negotiable 
Line type Switched 
Effective capacity 4000000 bits per second 
Cost per connect time 0 
Cost per byte 0 
Propagation delay 384.00 microseconds (local area network) 
User defined parameter 1 128 
User defined parameter 2 128 
User defined parameter 3 128 
Security Nonsecure 
2>Link name CLAUDLU1 
Adjacent node CP name 
Adjacent node type Learn 
DLC name IBMTRNET 
Adapter number 1 
Destination DLC address X'400032BB119B04' 
CP-CP session support Yes 
Preferred NN server No 
Auto-activate link Yes 
Transmission group number 0 
Limited resource No 
Solicit SSCP session | No 
Init self No 
BIND support Yes 
Link station role Negotiable 
Line type Switched 
Effective capacity 4000000 bits per second 
Cost per connect time Q 
Cost per byte 0 
Propagation delay 384.00 microseconds (local area network) 
User defined parameter 1 128 
User defined parameter 2 128 
User defined parameter 3 128 
Security Nonsecure 


Active Links Information 


KREKEEEREEEEKKREREREEEREEREREREREREEERER 


* Active Links Information * 
KKEEKEKREREKRERERKERKEKEKEREKEREEEEREREEERE 
Number of active links 2 
1>Link name RAKSA20 
DLC name IBMTRNET 
Adapter number 0 
Destination DLC address X'40000124000004' 
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Link activated 

Link state 

Deactivating link 

Active and activating sessions 
Max frame data (BTU) size 
Adjacent node CP name 
Adjacent node type 

CP-CP session support 
Connection type 

Link station role 

Line type 

Transmission group number 
Effective capacity 

Cost per connect time 
Cost per byte 

Propagation delay 

User defined parameter 1 
User defined parameter 2 
User defined parameter 3 . 
Security 


Link name 

DLC name 

Adapter number 
Destination DLC address 
Link activated | 
Link state 

Deactivating link 

Active and activating sessions 
Max frame data (BTU) size 
Adjacent node CP name 
Adjacent node type 

CP-CP session support 
Connection type 

Link station role 

Line type 

Transmission group number 
Effective capacity 

Cost per connect time 
Cost per byte 

Propagation delay 

User defined parameter 1 
User defined parameter 2 
User defined parameter 3 
Security 


Logical Units 0 to 3 Information 
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HAKKAR KKK ERK RRR ERK RRR RRR RRR RK ER ERIKA | 


* 


Logical Units 0 to 3 Information 
KKEEKEKEKEKEKEEREKEKREKREREREEREREREREEREEE 


Number of LUs 


1>Access type 


Networking Services/2 


LU type 

LU local address 
LU short name 

LU long name 
Session ID 


* 


Locally 

Active 

No 

8 

1033 

USTBMRA. RAK 

LEN 

No 

Host and peer 

Secondary 

Switched 

0 

4000000 bits per second 
0 

) 

384.00 microseconds (local area network) 
128 

128 

128 

Nonsecure 


CLAUDLU1 

IBMT RNET 

1 
X'400032BB119B04' 
Locally 

Active 

No 

5 

1033 
USIBMRA.CLAUDLUI 
End node 

Yes 

Peer 

Primary 

Switched 

21 

4000000 bits per second 
Q 

Q 

384.00 microseconds (local area network) 
128 

128 

128 

Nonsecure 


4 


3270 emulation 

2 

X'02! 

A 

A 
X'OOOOOHEKOOEOE0ARD' 


DLC name 

Adapter number 
Destination DLC address 
Link ID 

SSCP-LU session state 
LU-LU session state 


2>Access type 
LU type 
LU local address 
LU short name 
LU long name 
Session ID 
DLC name 
Adapter number 
Destination DLC address 
Link ID 
SSCP-LU session state 
LU-LU session state 


3>Access type 
LU type 
LU local address 
LU short name 
LU long name 
Session ID 
DLC name 
Adapter number 
Destination DLC address 
Link ID 
SSCP-LU session state 
LU-LU session state 


4>Access type 
LU type 
LU local address 
LU short name 
LU long name 
Session ID 
DLC name 
Adapter number 
Destination DLC address 
Link ID 
SSCP-LU session state 
LU-LU session state 


Logical Unit 6.2 Information 


KREKEEKEREKEKREKEREKREREKEEKEEREEERERKEKEEKE 


. Logical Unit 6.2 Information 


* 


KEKEKEKEKKKEEKEKREREREREREREKEKEREKEREREKRE 


Number of logical units (LUs) 


1>LU name 
LU alias 
Fully-qualified LU name 
Default LU 
LU local address 
Configured sessions limit 


IBMTRNET 

0 

X'40000124000004' 
X'46E36F1CCA4EC 43204202309 ' 
Active 

Inactive 


3270 emulation 

2 

X'Q3! 

B 

B 
X'Q000OR0O000000000' 
IBMT RNET 

0 

X'40000124000004' 
X'46E36F 1CCA4EC 43204202309 ' 
Active 

Inactive 


3270 emulation 

2 

X'Q4! 

C 

C 
X'9OOHOOODNDOOE00D' 
IBMTRNET 

0 

X'40000124000004 ' 
X' 46E36F 1CCA4EC 43204202309 ' 
Active 

Inactive 


32/70 emulation 

A 

X'95! 

D 

D 
X'9OOOHGOONDOOOOND' 
IBMTRNET 

0 

X'40000124000004' 
X' 46E36F 1CCA4EC 43204202309 ' 
Active 

Inactive 


1 


HENRILU1 
HENRILU1 
USIBMRA.HENRILU1 
Yes 

Independent 
65535 
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Transaction programs limit 
LU type 
Number of partner LUs (PLUs) 


1.1>Partner LU alias 
Partner LU uninterpreted name 
Partner LU name 
Partner LU session limit 
DLC name 
Adapter number 
Destination DLC address 
Parallel sessions 
Session security 
Conversation security 
Already verified security 
Implicit partner 
Number of modes for this PLU 


1.1.1>Mode name 
Max RU size, lower limit 
Max RU size, upper limit 
Max negotiable session limit 
Current session limit 
Min negotiated winner limit 
Min negotiated loser limit 
Active session count 
Pending session count 
Auto-activated winner sessions 
Active winner sessions 
Active loser sessions 
Session termination count 
Drain source 
Drain target 
Pacing size 
Implicit mode 


1.1.2>Mode name 
Max RU size, lower limit 
Max RU size, upper limit 
Max negotiable session limit 
Current session limit 
Min negotiated winner limit 
Min negotiated loser limit 
Active session count 
Pending session count 
Auto-activated winner sessions 
Active winner sessions 
Active loser sessions 
Session termination count 
Drain source 
Drain target 
Pacing size 
Implicit mode 


1.1.3>Mode name 
Max RU size, lower limit 
Max RU size, upper limit 
Max negotiable session limit 
Current session limit 


224 Networking Services/2 


No limit | 
6.2 
2 


61000000 


USIBMRA. CLAUDLU1 
65535 


0 

Xt! 

Supported 

Not configured 
Configured, Active 
Not configured 

Yes 

3 


CPSVCMG 
d12 
296 


ee Se an eee ere 
oO 


No 


SNASVCMG 
o12 
256 


Z2zordod Ore FR ke PM PP 


rm = 
oO 


Min negotiated winner limit ) 
Min negotiated loser limit 4 
Active session count 1 
Pending session count Q 
Auto-activated winner sessions Q 
Active winner sessions 0 
Active loser sessions i 
Session termination count Q 
Drain source Yes 
Drain target Yes 
Pacing size 3 
Implicit mode Yes 
1.2>Partner LU alias RALYOS2A 
Partner LU uninterpreted name X'OO00000000000000' 
Partner LU name USIBMRA. RALYOS2A 
Partner LU session limit 65535 
DLC name 
Adapter number 0 
Destination DLC address ) ae. 
Parallel sessions Supported 
Session security Not configured 
Conversation security Configured, Active 
Already verified security Not configured 
Implicit partner No 
Number of modes for this PLU 2 
1.2.1>Mode name SNASVCMG 
Max RU size, lower limit 512 
Max RU size, upper limit 256 
Max negotiable session limit 2 
Current session limit 2 
Min negotiated winner limit 1 
Min negotiated loser limit 1 
Active session count i 
Pending session count 0 
Auto-activated winner sessions 0 
Active winner sessions 0 
Active loser sessions 1 
Session termination count 0 
Drain source No 
Drain target No 
Pacing size i 
Implicit mode No 
1.2.2>Mode name MODE1 
Max RU size, lower limit 1024 
Max RU size, upper limit 256 
Max negotiable session limit 8 
Current session limit 2 
Min negotiated winner limit 0 
Min negotiated loser limit Q 
Active session count ui 
Pending session count Q 
Auto-activated winner sessions 0 
Active winner sessions 0 
Active loser sessions 1 
Session termination count 0 
Drain source No 
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Drain target 
Pacing size 
Implicit mode 


LU Definition Information 


KKK EKA KEKE EER REE ERE KEK ERERERRRERERE 


* LU Definition Information _ * 
KREKREREREKRREKEKREREKREREKREKEKREEKEKKKRKEK 


Number of logical units (LUs) 


1>LU name 
LU alias 
LU local address 


Management Services Information 


KEEKKEREREKEEREEKREERERERERRKRERERERERERSE 


* Management Services Information * 
KERKKEKEEREREREREREKEEEKREREKKKEREKKKRERKEEES 
Number of held MDS alerts 

Number of held NMVT alerts 

Number of focal points | 

Number of MS applications 

Number of active transactions 


Mode Definition Information 


KREKEKKEEKREKKEEREEREREREREREEKEREREEREKREEKE 


ba Mode Definition Information * 
KHEEKEKKKKEKKEEKERKEEKEE REE EKREKKREREERESR 


Number of modes 


1>Mode name 
Class of service name 
Max RU size, upper limit 
Receive pacing window 
Default RU size 
Max negotiable session limit 
Current session limit 
Min negotiated winner limit 


2>Mode name 
Class of service name 
Max RU size, upper limit 
Receive pacing window 
Default RU size 
Max negotiable session limit 
Current session limit 
Min negotiated winner limit 


3>Mode name 
Class of service name 
Max RU size, upper limit 
Receive pacing window 
Default RU size 
Max negotiable session limit 
Current session limit 
Min negotiated winner limit 


Networking Services/2 


No 


No 


1 


HENRILU1 
HENRILU1 
X19Q! 


Oooo eo © 


#CONNECT 
2048 

3 

Yes 

8 

8 

4 


#BATCH 
#BATCH 
2048 
3. 

Yes 

8 

8 

4 


#BATCHSC 
#BATCHSC 
2048 

3 

Yes 

8 

8 

4 


4>Mode name 
Class of service name 
Max RU size, upper limit 
Receive pacing window 
Default RU size 
Max negotiable session limit 
Current session limit 
Min negotiated winner limit 


5>Mode name 
Class of service name 
Max RU size, upper limit 
Receive pacing window 
Default RU size 
Max negotiable session limit 
Current session limit 
Min negotiated winner limit 


6>Mode name 
Class of service name 
Max RU size, upper limit 
Receive pacing window 
Default RU size 
Max negotiable session limit 
Current session limit 
Min negotiated winner limit 


7>Mode name 
Class of service name 
Max RU Size, upper iimit 
Receive pacing window 
Default RU size 
Max negotiable session limit 
Current session limit 
Min negotiated winner limit 


8>Mode name 
Class of service name 
Max RU size, upper limit 
Receive pacing window 
Default RU size 
Max negotiable session limit 
Current session limit 
Min negotiated winner limit 


Partner LU Definition Information 


KEKEKEKEKEREKRERERREREEKRREEEKEEKERREEKEEESE 


* Partner LU Definition Information 


* 


KREREKREEKEREEKEREEEKRREKREKEREEEKEEERERE 


Number of partner logical units 


1>Partner LU name 
Partner LU alias 
Partner LU uninterpreted name 


Maximum logical record send size 


Conversation security 
Parallel sessions 


#INTER 
#INTER 
2048 

7 

Yes 

8 

8 

4 


#INTERSC 
#INTERSC 
2048 

7, 

Yes 

8 

8 

4 


CPSVCMG 
CPSVCMG 
512 

1 

No 

2 

2 

1 


SNASVCMG 
SNASVCMG 
512 

1 

No 

2 

2 

1 


MODE] 
#CONNECT 
2048 

3 

Yes 

8 

8 

4 


2 


USIBMRA.RALYOS2A 
RALYOS2A 
X'O0OEONNEOOO0ON0D' 
32767 

No 

Supported 
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e>Partner LU name 
Partner LU alias 
Partner LU uninterpreted name 
Maximum logical record send size 
Conversation security 
Parallel sessions 


Session Information 
KEKEKKERKEKEKREERKKRERERERERERKKEREEKEEKRKREK 


* Session Information * 
KREKKEKEREKKKEREKKRKEEEKEREKEKREERREKRREREES 


Number of sessions 


1>Session ID 
Conversation ID 
LU alias 
Partner LU alias 
Mode name 
Send maximum RU size 
Receive maximum RU size 
Send pacing window 
Receive pacing window 
Link name 
Outbound destination address (DAF) 
Qutbound origin address (OAF) 
OAF-DAF assignor indicator (ODAT) 
Session type 
Connection type 
Procedure correlator ID (PCID) 
PCID generator CP name 
Conversation group ID 
LU name 
Partner LU name 
Pacing type 


2>Session ID 
Conversation ID 
LU alias 
Partner LU alias 
Mode name 
Send maximum RU size 
Receive maximum RU size 
Send pacing window 
Receive pacing window 
Link name 
Outbound destination address (DAF) 
Outbound origin address (OAF) 
OAF-DAF assignor indicator (ODAI) 
Session type 
Connection type 
Procedure correlator ID (PCID) 
PCID generator CP name 
Conversation group ID 
LU name 
Partner LU name 
Pacing type 


3>Session ID 


228 = Networking Services/2 


USIBMRA.CLAUDLU1 
19000000 : 


32/76/ 
No 
Supported 


7 


X'10228F 1CDC4EC 432! 
X'00000000' 
HENRILUI 


512 

256 

0 

0 

RAKSA20 

X'00! 

X'00! 

B'Q! 

SSCP-PU session 
Host and peer 
X'4040404040404040' 


X'090000000' 
USTBMRA.HENRILU1 


Fixed 


X'OELABFICD24EC432' 
X' 00000000! 
HENRILUI 
@1000000 

CPSVCMG 

O12 

512 

1 

1 

CLAUDLU1 

X'02! 

X'O1! 

Bd! 

LU-LU session 
Peer 
X'F453930FB3D17E8C'! 
USTBMRA. CLAUDLU1 
X' 90000000! 
USTBMRA. HENRILUI 
USIBMRA. CLAUDLU1 
Adaptive 


X'OC128F 1CDO4EC432 ! 


Conversation ID 

LU alias 

Partner LU alias 

Mode name 

Send maximum RU size 

Receive maximum RU size 

Send pacing window 

Receive pacing window 

Link name 

Outbound destination address (DAF) 
Outbound origin address (OAF) 
OAF-DAF assignor indicator (ODAI) 
Session type 

Connection type 

Procedure correlator ID (PCID) 
PCID generator CP name 
Conversation group ID 

LU name 

Partner LU name 

Pacing type 


4>Session ID 


Conversation ID 

LU alias 

Partner LU alias 

Mode name 

Send maximum RU size 

‘Receive maximum RU size 

Send pacing window 

Receive pacing window 

Link name 

Outbound destination address (DAF) 
Outbound origin address (OAF) 
OAF-DAF assignor indicator (ODAI) 
Session type 

Connection type 

Procedure correlator ID (PCID) 
PCID generator CP name 
Conversation group ID 

LU name 

Partner LU name 

Pacing type 


5>Session ID 


Conversation ID 

LU alias 

Partner LU alias 

Mode name 

Send maximum RU size 

Receive maximum RU size 

send pacing window 

Receive pacing window 

Link name 

Outbound destination address (DAF) 
Outbound origin address (OAF) 
OAF-DAF assignor indicator (ODAT) 
Session type 

Connection type 

Procedure correlator ID (PCID) 


X'90000000' 
HENRILU1 
@T000000 

CPSVCMG 

O12 

512 

l 

1 

CLAUDLU1 

X'01! 

X'02! 

B! 0 

LU-LU session 
Peer 
X'E6DB8C2499634315' 
USIBMRA.HENRILU1 
X'00000000' 
USIBMRA.HENRILU1 
USIBMRA. CLAUDLU1 
Adaptive 


X' 183C8F 1CE44EC432 ! 
X'00000000' 
HENRILU1 

@TQ00000 

SNASVCMG 

512 

912 

] 


4 
4 


CLAUDLU1 

x02" 

X'93! 

B'1! 

LU-LU session 
Peer 
X'F453930FB5D17E8C ! 
USIBMRA.CLAUDLU1 
X'90000000' 
USIBMRA. HENRILU1 
USIBMRA. CLAUDLU1 
Adaptive 


X'1C508F1CEA4EC432 ' 
X'1C6FFC36! 
HENRILU1 

@IOB0000 

MODE1 

1024 

1024 

1 

3 

CLAUDLUI 

X'02! 

X'04! 

B'y' 

LU-LU session 

Peer 
X'F453930FB6D17E8C! 
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PCID generator CP name 
Conversation group ID 
LU name 

Partner LU name 

Pacing type 


6>Session ID 


]/> 


Conversation ID 

LU alias 

Partner LU alias 

Mode name 

Send maximum RU size 

Receive maximum RU size 

Send pacing window 

Receive pacing window 

Link name 

Outbound destination address (DAF) 
Outbound origin address (OAF) 
OAF-DAF assignor indicator (ODATI) 
Session type 

Connection type 

Procedure correlator ID (PCID) 
PCID generator CP name 
Conversation group ID 

LU name 

Partner LU name 

Pacing type 


Session ID 

Conversation ID 

LU alias 

Partner LU alias 

Mode name 

Send maximum RU size 
Receive maximum RU size 
Send pacing window 
Receive pacing window 
Link name 


Outbound destination address (DAF) 


Outbound origin address (OAF) 
OAF-DAF assignor indicator (ODAI) 
Session type 

Connection type 

Procedure correlator ID (PCID) 
PCID generator CP name 
Conversation group ID 

LU name 

Partner LU name 

Pacing type 


Gateway Information 


230 


KREEKEKEKEKREREREKEREREREEEREREREREKREKERER 


* 


KREEKKEREREKREREKEKREREREEREEREREREEEEESR 


Nu 


Networking Services/2 


Gateway Information 


mber of configured gateway LUs 


USTBMRA.CLAUDLU1 
X'ED4EC432! | 
USTBMRA.HENRILUI1 
USIBMRA.CLAUDLU1 
Adaptive 


X'1E588F 1CFQO4EC432' 
X'Q0000000' 
HENRILU1I 
RALYOS2A 
SNASVCMG 

Oe 

512 

1 

1 

RAKSA20 

X'02!' 

X'00' 

B'0! 

LU-LU session 
Host and peer 
X'C1773C1F/8F65D45 ' 
USIBMRA. RALYOS2A 
X'00000000' 
USIBMRA.HENRILU1 
USIBMRA. RALYOS2A 
Adaptive 


X'226C8F1CF64EC432' 
X'1C097022C' 
HENRILUI 
RALYOS2A 

MODE1 

1024 

1024 

1 

3 

RAKSA20 

X'Q2! 

X'Q1! 

BQ! 

LU-LU session 
Host and peer 
X'C1773C1F79F65D45 ' 
USTBMRA. RALYOS2A 
X'FO4EC 432! 
USIBMRA.HENRILUI 
USIBMRA. RALYOS2A 
Adaptive 


System Default Information 
KKKEKKKKEKEEKKEREREEKEEKEKKEKEKREEEREREEEES 
. System Default Information : 
KEKEKEKREKEREREKKREKREREREKRERREREREEREEERE 
Default mode name 
Default local LU name 
Implicit partner LU support 
Maximum held alerts 
Conversation security required 
Maximum logical record send size 
Default TP directory 
Default TP operation 
Default TP program type 


Transaction Program Definitions 
KKEEREKREEREREKREREEEKEKKEKEEREREREKEEKERESR 
* Transaction Program Definitions * 
KKEKEKEEKEKEKEKEKEKERREREKEKKREKREEEKRERKEEEEE 
Attach manager active 
Defined transaction programs 


1>Transaction program name 
File name 
Program parameter string 
Synchronization level none 
Synchronization level confirm 
Conversation type 
Incoming allocate queue limit 
Incoming allocate queue depth 
Incoming allocate timeout 
Receive allocates pending 
Receive allocate timeout 
Transaction program type 
Program state 
Conversation security required 
Process ID 
Program type 
Transaction program initiated 
Icon file 


Active Transaction Programs 
KAKKEKEKKEKEKKKEKEEKEKKEKEKEKEKEKEREREKRKEEKEEESE 


* Active Transaction Programs * 
KEEKEKKEKRKEKEKKEKRKREKRKEKEKERKEKEKEEEEKEKRER 


Active transaction programs 


1>Transaction program name 
Transaction program ID 
User ID 
Transaction program initiated 
LU alias 
Logical unit of work name 
Logical unit of work instance 
Logical unit of work sequence 
Number of conversations 


1.1>Conversation ID 


HENRILU1 
Yes 

10 

No 

3276/7 

* 


Non-queued attach manager started 
Background 


Yes 
1 


SERVEUR 
D:\LEMANS\TP2SVR. EXE 


Supported 

Supported 

Either basic or mapped 

295 

Non-queued program 

Hold forever 

Non-queued program 

Hold forever 

Non-queued attach manager started 
Inactive 

No 

Not known to attach manager 
Full screen 

Remotely 


2 


SERVEUR 
X'1TA448F 1CEF4EC432' 


Remotely 
HENRILU1 
USTBMRA.CLAUDLUI 
X'A38C5/BB5/97'! 
X'0001' 

i} 


X'1C6FFC36! 
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Conversation state 
Session ID 
Synchronization level 
Conversation type 
Conversation group ID 


2>Transaction program name 
Transaction program ID 
User ID 
Transaction program initiated 
LU alias 
Logical unit of work name 
Logical unit of work instance 
Logical unit of work sequence 
Number of conversations 


2.1>Conversation ID 
Conversation state 
Session ID 
Synchronization level 
Conversation type 
Conversation group ID 


X.25 Physical Link Information 


KEEKREEEKERERERKRERREERERERERERERERERRREREER 


*  X.25 Physical Link Information * 


KRREEEKERKEEEKREEERKEREKEREREREEEKREREREREEEE 


Send 

X'1C508F 1CEA4EC 432! 
Confirm 

Mapped 

X'32C44EED'! 


SERVEUR 
X'20608F 1CFB4EC432 ' 


Remotely 
HENRILU1 
USIBMRA. RALYOS2A 
X'A38C57C4EFA5 ' 
X'0001' 

i! 


X'1C097022C! 

Send 
X'226C8FICF64EC 432! 
Confirm 

Mapped 

X'32C44EF9! 


The X.25 Communications Subsystem is not loaded. 


B.2 APPN 
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KEEKEEREEEREREERERERERERKEREREEERERERERSE 


* Class of Service Information i 
KEKAEKKEEKKEEKKEKEKKER KKK KKKRKKREKRKEEKEKREEKEEE 


Number of class of service definitions 


l>Class of service name 
Transmission priority 
Number of node rows 
Number of TG rows 


1.1>Node row weight 
Congestion min 
Congestion max 
Route additional resistance min 
Route additional resistance max 


1.2>Node row weight 
Congestion min 
Congestion max 
Route additional resistance min 
Route additional resistance max 


1.3>Node row weight 
Congestion min 


Networking Services/2 


/ 


#CONNECT 
Medium 


Congestion max 


Route additional resistance min 0 
Route additional resistance max 95 
1.4>Node row weight 40 
Congestion min No 
Congestion max No 
Route additional resistance min 0) 
Route additional resistance max 127 
1.5>Node row weight 60 
Congestion min No 
Congestion max No 
Route additional resistance min 0 
Route additional resistance max 159 
1.6>Node row weight 80 
Congestion min No 
Congestion max No 
Route additional resistance min 0 
Route additional resistance max 191 
1.7>Node row weight 120 


Congestion min No 


Congestion max Yes 

Route additional resistance min 0 

Route additional resistance max 223 
1.8>Node row weight 160 


Congestion min No 


Congestion max Yes 

Route additional resistance min 9) 

Route additional resistance max 255 
1.1>TG row weight 30 

Cost per connect time min 6) 

Cost per connect time max 0 

Cost per byte min 0 

Cost per byte max 0 

Security min Nonsecure 


Maximum security 

0.00 seconds (minimum) 

384.00 microseconds (local area network) 
4.30 megabits per second 

603.98 gigabits per second 


Security max 
Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 


User defined parameter 1 min Q 
User defined parameter 1 max 259 
User defined parameter 2 min 0 
User defined parameter 2 max 255 
User defined parameter 3 min 0 
User defined parameter 3 max 2900 
1.2>TG row weight 60 
Cost per connect time min 0 
Cost per connect time max 0 
Cost per byte min 0 
Cost per byte max 0 
Security min Nonsecure 


Security max Maximum security 
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Propagation delay min 0.00 seconds (minimum) 


Propagation delay max 9.22 milliseconds (telephone) 
Effective capacity min | 57.60 kilobits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min 0 
User defined parameter 1 max 200 
User defined parameter 2 min 0 
User defined parameter 2 max 299 
User defined parameter 3 min 0 
User defined parameter 3 max 255 

1.3>TG row weight 90 
Cost per connect time min e) 
Cost per connect time max ) 
Cost per byte min ) 
Cost per byte max 0 
Security min Nonsecure 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 9.22 milliseconds (telephone) 
Effective capacity min 19.20 kilobits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min 0 
User defined parameter 1 max 299 
User defined parameter 2 min Q 
User defined parameter 2 max 295 
User defined parameter 3 min 0 
User defined parameter 3 max 299 

1.4>TG row weight — 120 
Cost per connect time min 0 
Cost per connect time max 0 
Cost per byte min 0 
Cost per byte max 0 
Security min Nonsecure 
Security max | Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 9.22 milliseconds (telephone) 
Effective capacity min 9.60 kilobits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min 0 
User defined parameter 1 max 299 
User defined parameter 2 min Q 
User defined parameter 2 max 205 
User defined parameter 3 min 9) 
User defined parameter 3 max 295 

1.5>TG row weight 150 
Cost per connect time min Q 
Cost per connect time max Q 
Cost per byte min 0 
Cost per byte max Q 
Security min Nonsecure 
Security max : Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 147.46 milliseconds (packet switched network) 
Effective capacity min 19.20 kilobits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min 0 
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User defined parameter 1 max 255 


User defined parameter 2 min 0 
User defined parameter 2 max 255 
User defined parameter 3 min 0 
User defined parameter 3 max 255 
1.6>TG row weight 180 
Cost per connect time min 0 
Cost per connect time max 128 
Cost per byte min 0 
Cost per byte max 128 
Security min Nonsecure 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 147.46 milliseconds (packet switched network’ 
Effective capacity min 9.60 kilobits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min 0 
User defined parameter 1 max 255 
User defined parameter 2 min 0 
User defined parameter 2 max 295 
User defined parameter 3 min ) 
User defined parameter 3 max 255 
1.7>TG row weight 210 
Cost per connect time min Q 
Cost per connect time max 196 
Cost per byte min e) 
Cost per byte max 196 
Security min Nonsecure 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 2013.27 seconds (maximum) 
Effective capacity min 4.80 kilobits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min 0 
User defined parameter 1 max 299 
User defined parameter 2 min 9) 
User defined parameter 2 max 295 
User defined parameter 3 min 0 
User defined parameter 3 max 255 
1.8>TG row weight 240 
Cost per connect time min 0 
Cost per connect time max 255 
Cost per byte min 0 
Cost per byte max 255 
Security min Nonsecure 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 2013.27 seconds (maximum) 
Effective capacity min 0.00 bits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min ) 
User defined parameter 1 max 255 
User defined parameter 2 min Q 
User defined parameter 2 max | 255 
User defined parameter 3 min 0 
User defined parameter 3 max 255 
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2>Class of service name 
Transmission priority 


RO 


Po 


No 


Networking Services/2 


Number of node rows 


Number of TG rows 


.1>Node row weight 


Congestion min 
Congestion max 
Route additional 
Route additional 


.o>Node row weight 


Congestion min 
Congestion max 
Route additional 
Route additional 


.3>Node row weight 


Congestion min 
Congestion max 
Route additional 
Route additional 


.4>Node row weight 


Congestion min 
Congestion max 
Route additional 
Route additional 


.5>Node row weight 


Congestion min 
Congestion max 
Route additional 
Route additional 


.6>Node row weight 


Congestion min 
Congestion max 
Route additional 
Route additional 


.7/>Node row weight 


Congestion min 
Congestion max 
Route additional 
Route additional 


.8>Node row weight 


Congestion min 
Congestion max 
Route additional 
Route additional 


.1>TG row weight 


resistance 
resistance 


resistance 
resistance 


resistance 
resistance 


resistance 
resistance 


resistance 
resistance 


resistance 
resistance 


resistance 
resistance 


resistance 
resistance 


Cost per connect time min 
Cost per connect time max 


Cost per byte min 
Cost per byte max 


min 
max 


min 
max 


min 
max 


min 
max 


min 
max 


min 
max 


min 
max 


min 
max 


CPSVCMG 
Network 
8 


Security min 

Security max 

Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 

User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


2.27>1G row weight 
Cost per connect time min 
Cost per connect time max 
Cost per byte min 
Cost per byte max 
Security min 
Security max 
Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 
User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
user defined parameter 3 max 


2.3>T1G row weight 
Cost per connect time min 
Cost per connect time max 
Cost per byte min 
Cost per byte max 
Security min 
Security max 
Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 
User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 


User defined parameter 3 max 


2.4>1G row weight 
Cost per connect time min 
Cost per connect time max 
Cost per byte min 
Cost per byte max 
Security min 
Security max 
Propagation delay min 
Propagation delay max 
Effective capacity min 


Nonsecure 
Maximum security 
0.00 seconds (minimum) 


384.00 microseconds (local area network) 


4.30 megabits per second 
603.98 gigabits per second 
Q 

£99 

0 


255 


0 
255 


60 

0 

0 

0 

0 

Nonsecure 

Maximum security 

9.00 seconds (minimum) 
9.22 milliseconds (telephone) 
57.60 kilobits per second 
603.98 gigabits per second 
0 

255 

0 

255 

0 

255 


90 

0 

0 

Q 

0 

Nonsecure 

Maximum security 

0.00 seconds (minimum) 
9.22 milliseconds (telephone) 
19.20 kilobits per second 
603.98 gigabits per second 
0 

299 

0 

295 

0 

255 


120 

Q 

0 

Q 

Q 

Nonsecure 

Maximum security 

0.00 seconds (minimum) 

9.22 milliseconds (telephone) 
9.60 kilobits per second 
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238 


Effective capacity max 


User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


2.5>1TG row weight 


Cost per connect time min 
Cost per connect time max 
Cost per byte min 

Cost per byte max 
Security min 

Security max 

Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 
User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


2.6>TG row weight 


Cost per connect time min 
Cost per connect time max 
Cost per byte min 

Cost per byte max 
Security min 

Security max 

Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 
User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


2./>1G row weight 


Networking Services/2 


Cost per connect time min 


Cost per connect time max 


Cost per byte min 

Cost per byte max 

Security min 

Security max 

Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 

User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 


603.98 gigabits per second 
0 

259 

0 

255 

0 

255 


150 
0 
0 
0 


mC) 


Nonsecure 
Maximum security 
0.00 seconds (minimum) 


147.46 milliseconds (packet switched network) 


19.20 kilobits per second 
603.98 gigabits per second 
0 

255 

0 

255 

0 

255 


180 

0 

128 

0 

128 

Nonsecure 

Maximum security 

0.00 seconds (minimum) 


147.46 milliseconds (packet switched network) 


9.60 kilobits per second 
603.98 gigabits per second 
0 

255 

0 

299 

6) 

295 


210 

0 

196 

0 

196 

Nonsecure 

Maximum security 

0.00 seconds (minimum) 
2013.27 seconds (maximum) 
4.80 kilobits per second 
603.98 gigabits per second 
0 

255 

0 

295 


User defined parameter 3 min 0 


User defined parameter 3 max 255 
2.8>1G row weight 240 
Cost per connect time min 0 
Cost per connect time max 299 
Cost per byte min Q 
Cost per byte max 299 
Security min Nonsecure 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 2013.27 seconds (maximum) 
Effective capacity min 0.00 bits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min 0 
User defined parameter 1 max 2099 
User defined parameter 2 min Q 
User defined parameter 2 max 255 
User defined parameter 3 min 0 
User defined parameter 3 max 200 
3>Class of service name SNASVCMG 
Transmission priority Network 
Number of node rows 8 
Number of TG rows 8 
3.1>Node row weight 5 
Congestion min No 
Congestion max No 
Route additional resistance min 0 
Route additional resistance max 31 
3.2>Node row weight 10 
Congestion min No 
Congestion max No 
Route additional resistance min 0 
Route additional resistance max 63 
3.3>Node row weight 20 
Congestion min No 
Congestion max No 
Route additional resistance min 0 
Route additional resistance max 95 
3.4>Node row weight 40 
Congestion min No 
Congestion max No 
Route additional resistance min 0 
Route additional resistance max 127 
3.5>Node row weight 60 
Congestion min No 
Congestion max No 
Route additional resistance min 0 
Route additional resistance max 159 
3.6>Node row weight 80 
Congestion min No 
Congestion max : No 
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Route additional resistance min 0 


Route additional resistance max 191 
3./>Node row weight 120 
Congestion min No 
Congestion max Yes 
Route additional resistance min 6) 
Route additional resistance max 223 
3.8>Node row weight 160 
Congestion min No 
Congestion max Yes 
Route additional resistance min 0 
Route additional resistance max 209 
3.1>TG row weight 30 
Cost per connect time min 0 
Cost per connect time max 0) 
Cost per byte min 0 
Cost per byte max 0 
Security min Nonsecure 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 384.00 microseconds (local area network) 
Effective capacity min 4,30 megabits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min ) 
User defined parameter 1 max 299 
User defined parameter 2 min 0 
User defined parameter 2 max 209 
User defined parameter 3 min ) 
User defined parameter 3 max 295 
3.2>TG row weight 60 
Cost per connect time min 0 
Cost per connect time max 9) 
Cost per byte min 0 
Cost per byte max ) 
Security min Nonsecure 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 9.22 milliseconds (telephone) 
Effective capacity min | 57.60 kilobits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min 0 
User defined parameter 1 max 255 
User defined parameter 2 min 0 
User defined parameter 2 max 299 
User defined parameter 3 min 0 
User defined parameter 3 max 295 
3.3>1G row weight 90 
Cost per connect time min 0 
Cost per connect time max 0 
Cost per byte min 0 
Cost per byte max 0 
Security min Nonsecure 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
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Propagation delay max 9.22 milliseconds (telephone) 


Effective capacity min 19.20 kilobits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min 0 
User defined parameter 1 max 25) 
User defined parameter 2 min 0 
User defined parameter 2 max 755 
User defined parameter 3 min 0 
User defined parameter 3 max 209 

3.4>TG row weight 120 
Cost per connect time min Q 
Cost per connect time max 0 
Cost per byte min Q 
Cost per byte max 0 
Security min Nonsecure 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 9.22 milliseconds (telephone) 
Effective capacity min 9.60 kilobits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min Q 
User defined parameter 1 max 295 
User defined parameter 2 min 0 
User defined parameter 2 max 255 
User defined parameter 3 min ) 
User defined parameter 3 max 255 

3.5>TG row weight 150 
Cost per connect time min 6) 
Cost per connect time max 0 
Cost per byte min 0 
Cost per byte max 0 
Security min Nonsecure 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 147.46 milliseconds (packet switched network) 
Effective capacity min 19.20 kilobits per second 
Effective capacity max 603.98 gigabits per second 


User defined parameter 1 min Q 
User defined parameter 1 max 295 
User defined parameter 2 min ) 
User defined parameter 2 max 299 
3 
3 


User defined parameter 3 min 0 


User defined parameter 3 max 255 

3.6>1TG row weight 180 
Cost per connect time min 0 
Cost per connect time max 128 
Cost per byte min 0 
Cost per byte max | 128 
Security min Nonsecure 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 147.46 milliseconds (packet switched network) 
Effective capacity min 9.60 kilobits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min Q 
User defined parameter 1 max 255 
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User defined parameter 2 min ) 


User defined parameter 2 max 295 
User defined parameter 3 min Q 
User defined parameter 3 max 209 
3.7>TG row weight 210 
Cost per connect time min Q 
Cost per connect time max 196 
Cost per byte min —_ 0 
Cost per byte max 196 
Security min Nonsecure 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 2013.27 seconds (maximum) 
Effective capacity min 4.80 kilobits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min ) 
User defined parameter 1 max 200 
User defined parameter 2 min ) 
User defined parameter 2 max 295 
User defined parameter 3 min 0 
User defined parameter 3 max 295 
3.8>TG row weight 240 
Cost per connect time min. 0 
Cost per connect time max 295 
Cost per byte min 0 
Cost per byte max 255 
Security min Nonsecure 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 2013.27 seconds (maximum) 
Effective capacity min 0.00 bits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min ) 
User defined parameter 1 max 255 
User defined parameter 2 min 0 
User defined parameter 2 max 299 
User defined parameter 3 min 0 
User defined parameter 3 max 255 
4>Class of service name #INTER 
Transmission priority , — High 
Number of node rows 8 
Number of TG rows 8 
4,1>Node row weight | 45 
Congestion min . No 
Congestion max | No 
Route additional resistance min Q 
Route additional resistance max 31 
4.2>Node row weight 10 
Congestion min No 
Congestion max No 
Route additional resistance min fg) 
Route additional resistance max 63 


4,3>Node row weight 20 
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Congestion min No 


Congestion max No 

Route additional resistance min Q 

Route additional resistance max 95 
4.4>Node row weight 40 

Congestion min No 

Congestion max No 

Route additional resistance min 0 

Route additional resistance max 127 
4.5>Node row weight 60 

Congestion min No 

Congestion max No 

Route additional resistance min 0 

Route additional resistance max 159 
4.6>Node row weight 80 

Congestion min No 

Congestion max No 

Route additional resistance min 0 

Route additional resistance max 191 
4,7>Node row weight 120 

Congestion min No 

Congestion max Yes 

Route additional resistance min 0 

Route additional resistance max 223 
4.8>Node row weight 160 

Congestion min No 

Congestion max Yes 

Route additional resistance min 8) 

Route additional resistance max 255 
4.1>TG row weight 30 

Cost per connect time min 0 

Cost per connect time max 0 

Cost per byte min 0 

Cost per byte max Q 

Security min Nonsecure 

Security max Maximum security 

Propagation delay min 0.00 seconds (minimum) 

Propagation delay max 384.00 microseconds (local area network) 

Effective capacity min 4.30 megabits per second 

Effective capacity max 603.98 gigabits per second 

User defined parameter 1 min Q 

User defined parameter 1 max 295 

User defined parameter 2 min 0 

User defined parameter 2 max 295 

User defined parameter 3 min 0 

User defined parameter 3 max 255 
4.2>1G row weight 60 

Cost per connect time min 0 

Cost per connect time max 0 

Cost per byte min Q 

Cost per byte max 0 

Security min Nonsecure 


Appendix B. What PMDSPLAY Shows 243 


244 


Security max 

Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 

User defined parameter 1 min 


‘User defined parameter 1 max 


User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


4.3>1G row weight 


Cost per connect time min 
Cost per connect time max 
Cost per byte min 

Cost per byte max 

Security min 

Security max 

Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 

User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


4.4>TG row weight 


Cost per connect time min 
Cost per connect time max 
Cost per byte min 

Cost per byte max 
Security min 

Security max 

Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 


User defined parameter 1 min 


User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


4.5>TG row weight 
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Cost per connect time min 
Cost per connect time max 
Cost per byte min 

Cost per byte max 
Security min 

Security max 

Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 


Maximum security 


0.00 seconds (minimum) 


9.22 milliseconds (telephone) 
57.60 kilobits per second 
603.98 gigabits per second 

S) 

255 

0 

255 

0 

255 


90 

0 

128 

Q 

128 

Nonsecure 

Maximum security 

0.00 seconds (minimum) 
9.22 milliseconds (telephone) 
57.60 kilobits per second 
603.98 gigabits per second 
6) 

259 

0 

255 

0 

255 


120 

0 

0 

0 

) 

Nonsecure 

Maximum security 

0.00 seconds (minimum) 
9.22 milliseconds (telephone) 
19.20 kilobits per second 
603.98 gigabits per second 
G) 

255 

Q 

255. 

0 

255 


150 
0 
128 


0 


128 

Nonsecure 

Maximum security 

0.00 seconds (minimum) 


147.46 milliseconds (packet switched network) 


19.20 kilobits per second 
603.98 gigabits per second 


User defined parameter 1 min 0 


User defined parameter 1 max 255. 
User defined parameter 2 min Q 
User defined parameter 2 max 255 
User defined parameter 3 min 0 
User defined parameter 3 max 255 
4.6>TG row weight 180 
Cost per connect time min 0 
Cost per connect time max 0 
Cost per byte min 6) 
Cost per byte max 0 
Security min Nonsecure _ 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 147.46 milliseconds (packet switched network) 
Effective capacity min 9.60 kilobits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min 0 
User defined parameter 1 max 255 
User defined parameter 2 min 0 
User defined parameter 2 max 255 
User defined parameter 3 min 0 
User defined parameter 3 max 295 
4.7>1G row weight 210 
Cost per connect time min Q 
Cost per connect time max 196 
Cost per byte min 0 
Cost per byte max 196 
Security min Nonsecure 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 2013.27 seconds (maximum) 
Effective capacity min 9.60 kilobits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min 0 
User defined parameter 1 max 295 
User defined parameter 2 min 0 
User defined parameter 2 max 295 
User defined parameter 3 min 0 
User defined parameter 3 max 295 
4.8>1G row weight 240 
Cost per connect time min 0 
Cost per connect time max 295 
Cost per byte min Q 
Cost per byte max 295 
Security min Nonsecure 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 2013.27 seconds (maximum) 
Effective capacity min 0.00 bits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min 0 
User defined parameter 1 max 205 
User defined parameter 2 min 0 
User defined parameter 2 max 255 
User defined parameter 3 min 0 
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User defined parameter 3 max 


5>Class of service name 
Transmission priority 


Networking Services/2 


Number of node rows 


Number of TG rows 


.l>Node row weight 


Congestion min 
Congestion max 
Route additional 
Route additional 


.2>Node row weight 


Congestion min 
Congestion max 
Route additional 
Route additional 


.3>Node row weight 


Congestion min 
Congestion max 
Route additional 
Route additional 


.4>Node row weight 


Congestion min 
Congestion max 
Route additional 
Route additional 


.5>Node row weight 


Congestion min 
Congestion max 
Route additional 
Route additional 


.6>Node row weight 


Congestion min 
Congestion max 
Route additional 
Route additional 


./>Node row weight 


Congestion min 
Congestion max 
Route additional 
Route additional 


.8>Node row weight 


Congestion min 
Congestion max 
Route additional 
Route additional 


.1>TG row weight 


Cost per connect 
Cost per connect 


Cost per byte min 


resistance 
resistance 


resistance 
resistance 


resistance 
resistance 


resistance 
resistance 


resistance 
resistance 


resistance 
resistance 


resistance 
resistance 


resistance 


resistance 


time min 
time max 


min 
max 


min 
max 


min 
max 


min 
max 


min 
max 


min 
max 


min 
max 


min 
max 


229 
#INTERSC 


High 
8 


Cost per byte max 

Security min 

Security max 

Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 

User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


5.2>1G row weight 
Cost per connect time min 
Cost per connect time max 
Cost per byte min 
Cost per byte max 
Security min 
Security max 
Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 
User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


5.3>TG row weight 
Cost per connect time min 
Cost per connect time max 
Cost per byte min 
Cost per byte max 
Security min 
Security max 
Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 
User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


5.4>1TG row weight 
Cost per connect time min 
Cost per connect time max 
Cost per byte min 
Cost per byte max 
Security min 
Security max 
Propagation delay min 
Propagation delay max 


Q 

Public switched network 
Maximum security 

0.00 seconds (minimum) 


384.00 microseconds (local area network) 


4,30 megabits per second 
603.98 gigabits per second 
0 

255 

0 

255 

0 

255 


60 

0 

6) 

Q 

0 

Public switched network 
Maximum security 

0.00 seconds (minimum) 
9.22 milliseconds (telephone) 
57.60 kilobits per second 
603.98 gigabits per second 
Q 

255 

0 

255 

0 

255 


90 

0 

128 

6) 

128 

Public switched network 
Maximum security 

0.00 seconds (minimum) 
9.22 milliseconds (telephone) 
57.60 kilobits per second 
603.98 gigabits per second 
0 

255 

Q 

255 

Q 

250 


120 

0 

0 

0 

0 

Public switched network 
Maximum security 

0.00 seconds (minimum) 

9.22 milliseconds (telephone) 
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Effective capacity min 19.20 kilobits per second 


Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min 0 
User defined parameter 1 max 255 
User defined parameter 2 min 0 
User defined parameter 2 max 295 
User defined parameter 3 min 0 
User defined parameter 3 max 299 

5.5>TG row weight 150 
Cost per connect time min 0 
Cost per connect time max 128 
Cost per byte min 0 
Cost per byte max 128 
Security min Public switched network 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 147.46 milliseconds (packet switched network) 
Effective capacity min 19.20 kilobits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min 0 
User defined parameter 1 max 299 
User defined parameter 2 min 0 
User defined parameter 2 max 90 
User defined parameter 3 min 0 
User defined parameter 3 max 299 

5.6>1G row weight 180 
Cost per connect time min 0 
Cost per connect time max 0) 
Cost per byte min 9) 
Cost per byte max 0 
Security min Public switched network 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 147.46 milliseconds (packet switched network) 
Effective capacity min 9.60 kilobits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min 0 
User defined parameter 1 max 299 
User defined parameter 2 min Q 
User defined parameter 2 max 299 
User defined parameter 3 min Q 
User defined parameter 3 max 295 

5.7>TG row weight | 21¢€ 
Cost per connect time min 0 
Cost per connect time max 196 
Cost per byte min 0 
Cost per byte max 196 
Security min Public switched network 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 2013.27 seconds (maximum) 
Effective capacity min 9.60 kilobits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min 0 
User defined parameter 1 max 299 
User defined parameter 2 min 0 
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User defined parameter 2 max 205 


User defined parameter 3 min 0 
User defined parameter 3 max 255 
5.8>TG row weight 240 
Cost per connect time min 0 
Cost per connect time max 255 
Cost per byte min 0 
Cost per byte max 295 
Security min Public switched network 
Security max Maximum security 
Propagation delay min 0.00 seconds (minimum) 
Propagation delay max 2013.27 seconds (maximum) 
Effective capacity min 0.00 bits per second 
Effective capacity max 603.98 gigabits per second 
User defined parameter 1 min 0 
User defined parameter 1 max 299 
User defined parameter 2 min 0 
User defined parameter 2 max £00 
User defined parameter 3 min 0 
User defined parameter 3 max 259 
6>Class of service name #BATCH 
Transmission priority Low 
Number of node rows 8 
Number of TG rows 8 
6.1>Node row weight 2) 
Congestion min No 
Congestion max No 
Route additional resistance min Q 
Route additional resistance max a1 
6.2>Node row weight 10 
Congestion min No 
Congestion max No 
Route additional resistance min Q 
Route additional resistance max 63 
6.3>Node row weight 20 
Congestion min No 
Congestion max No 
Route additional resistance min 0 
Route additional resistance max 95 
6.4>Node row weight 40 
Congestion min No 
Congestion max No 
Route additional resistance min 0 
Route additional resistance max 127 
6.5>Node row weight 60 
Congestion min No 
Congestion max No 
Route additional resistance min 0 
Route additional resistance max 159 
6.6>Node row weight 80 
Congestion min No 
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250 


Congestion max 
Route additional 
Route additional 


6.7>Node row weight 


Congestion min 
Congestion max 
Route additional 
Route additional 


6.8>Node row weight 


Congestion min 
Congestion max 
Route additional 
Route additional 


6.1>TG row weight 
Cost per connect time min 
Cost per connect time max 


Cost per byte min 

Cost per byte max 
Security min 

Security max 
Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 
User defined parameter 
User defined parameter 
User defined parameter 
User defined parameter 
User defined parameter 
User defined parameter 


6.2>1G row weight 


Cost per 
Cost per 
Cost per 
Cost per byte max 
Security min 

Security max 
Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 
User defined parameter 
User defined parameter 
User defined parameter 
User defined parameter 
User defined parameter 
User defined parameter 


byte min 


6.3>TG row weight 
Cost per connect time min 
Cost per connect time max 


Networking Services/2 


Cost per byte min 
Cost per byte max 
Security min 
Security max 


resistance 
resistance 


resistance 
resistance 


resistance 
resistance 


1 min 
1 max 
2 min 
2 max 
3 min 
3 max 


connect time min 
connect time max 


1 min 
1 max 
2 min 
2 max 
3 min 
3 max 


min 
max 


min 
max 


min 
max 


Nonsecure 

Maximum security 

0.00 seconds (minimum) 
2013.27 seconds (maximum) 
57.60 kilobits per second 
603.98 gigabits per second 
0) 

255 

0 

259 

Q 

259 


60 

0 

9) 

0 

Q 

Nonsecure 

Maximum security 

0.00 seconds (minimum) 
2013.27 seconds (maximum) 
19.20 kilobits per second 
603.98 gigabits per second 
0 

255 

C) 

255 

0 

255 


90 

0 

128 

6) 

128 

Nonsecure 
Maximum security 


Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 

User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


6.4>TG row weight 
Cost per connect time min 
Cost per connect time max 
Cost per byte min 
Cost per byte max 
Security min 
Security max 
Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 


User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


6.5>1G row weight 
Cost per connect time min 
Cost per connect time max 
Cost per byte min 
Cost per byte max 
Security min 
Security max 
Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 
User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


6.6>TG row weight 
Cost per connect time min 
Cost per connect time max 
Cost per byte min 
Cost per byte max 
Security min 
Security max 
Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 
User defined parameter 1 min 


0.00 seconds (minimum) 
2013.27 seconds (maximum) 
19.20 kilobits per second 
603.98 gigabits per second 


0 


255 
0 
255 
0 
255 


120 

0 

0 

0 

0 

Nonsecure 

Maximum security 

0.00 seconds (minimum) 
2013.27 seconds (maximum) 
9.60 kilobits per second 
603.98 gigabits per second 
0 

255 


128 

Nonsecure 

Maximum security 

0.00 seconds (minimum) 
2013.27 seconds (maximum) 
9.60 kilobits per second 
603.98 gigabits per second 
0 

299 

0 

255 

0 

255 


180 

0 

196 

0 

196 

Nonsecure 

Maximum security 

0.00 seconds (minimum) 
2013.27 seconds (maximum) 
9.60 kilobits per second 
603.98 gigabits per second 
0 
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252 


User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


6.7>TG row weight 


Cost per connect time min 
Cost per connect time max 
Cost per byte min 

Cost per byte max 

Security min 

Security max 

Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 

User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


6.8>1G row weight 


Cost per connect time min 
Cost per connect time max 
Cost per byte min 

Cost per byte max 

Security min 

Security max 

Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 

User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


7>Class of service name 
Transmission priority 
Number of node rows 
Number of TG rows 


7.1>Node row weight 


Congestion min 
Congestion max 
Route additional resistance min 
Route additional resistance max 


7.2>Node row weight 


Networking Services/2 — 


Congestion min 
Congestion max 
Route additional resistance min 
Route additional resistance max 


255 
0 
250 
0 
299 


210 

9) 

196 

9) 

196 

Nonsecure 

Maximum security 

0.00 seconds (minimum) 
2013.27 seconds (maximum) 
4.80 kilobits per second 
603.98 gigabits per second 
Q 

299 

0 

295 

0 

2599 


240 

0 

295 

0 

255 

Nonsecure 

Maximum security 

0.00 seconds (minimum) 
2013.27 seconds (maximum) 
0.00 bits per second 
603.98 gigabits per second 
0 

295 

0 

295 

0 

259 


#BATCHSC 
Low 
8 


7.3>Node row weight 
Congestion min 
Congestion max 
Route additional 
Route additional 


7.4>Node row weight 
Congestion min 
Congestion max 
Route additional 
Route additional 


7.5>Node row weight 
Congestion min 
Congestion max 
Route additional 
Route additional 


7.6>Node row weight 
Congestion min 
Congestion max 
Route additional 
Route additional 


7./>Node row weight 
Congestion min 
Congestion max 
Route additional 
Route additional 


7.8>Node row weight 
Congestion min 
Congestion max 
Route additional 
Route additional 


7.1>TG row weight 


resistance 
resistance 


resistance 
resistance 


resistance 
resistance 


resistance 
resistance 


resistance 
resistance 


resistance 
resistance 


Cost per connect time min 
Cost per connect time max 


Cost per byte min 
Cost per byte max 


Security min 
Security max 


Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 


User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


7.2>1TG row weight 
Cost per connect time min 
Cost per connect time max 
Cost per byte min 
Cost per byte max 


min 
max 


min 
max 


min 
max 


min 
max 


min 
max 


min 
max 


Public switched network 
Maximum security 

0.00 seconds (minimum) 
2013.27 seconds (maximum) 
57.60 kilobits per second 
603.98 gigabits per second 
Q 

200 

0 

255 

0 

255 


Q 


ooo o Oo 
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254 


Security min 

Security max 

Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 

User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


7.3>TG row weight 


Cost per connect time min 
Cost per connect time max 
Cost per byte min 

Cost per byte max 
Security min 

Security max 

Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 


User defined parameter 1 min 

User defined parameter 1 max 

User defined parameter 2 min 

User defined parameter 2 max 

User defined parameter 3 min 

User defined parameter 3 max 
7.4>TG row weight 

Cost per connect time min 

Cost per connect time max 

Cost per byte min 

Cost per byte max 

Security min 

Security max 

Propagation delay min 

Propagation delay max 

Effective capacity min 

Effective capacity max 

User defined parameter 1 min 

User defined parameter 1 max 

User defined parameter 2 min 

User defined parameter 2 max 

User defined parameter 3 min 

User defined parameter 3 max 


7.5>TG row weight 


Networking Services/2 


Cost per connect time min 
Cost per connect time max 
Cost per byte min 

Cost per byte max 
Security min 

Security max 

Propagation delay min 
Propagation delay max 
Effective capacity min 


Public switched network 


Maximum security 


0.00 seconds (minimum) 
2013.27 seconds (maximum) 
19.20 kilobits per second 
603.98 gigabits per second 
0 

255 

0 

255 

0 

255 


90 


Q 

128 

Q 

128 

Public switched network 
Maximum security 

0.00 seconds (minimum) 
2013.27 seconds (maximum) 
19.20 kilobits per second 
603.98 gigabits per second 
0 

255 

0 

255 

Q 

255 


120 

0 

0 

0 

Q 

Public switched network 
Maximum security 

0.00 seconds (minimum) 
2013.27 seconds (maximum) 
9.60 kilobits per second 
603.98 gigabits per second 
0 

295 

0 

295 

9) 

255 


150 

Q 

128 

Q 

128 

Public switched network 
Maximum security 

0.00 seconds (minimum) 
2013.27 seconds (maximum) 
9.60 kilobits per second 


Effective capacity max 

User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


7.6>TG row weight 
Cost per connect time min 
Cost per connect time max 
Cost per byte min 
Cost per byte max 
Security min 
Security max 
Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 


User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


7./>1G row weight 
Cost per connect time min 
Cost per connect time max 
Cost per byte min 
Cost per byte max 
Security min 
Security max 
Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 
User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 
User defined parameter 3 min 
User defined parameter 3 max 


7.8>1G row weight 
Cost per connect time min 
Cost per connect time max 
Cost per byte min 
Cost per byte max 
Security min 
Security max 
Propagation delay min 
Propagation delay max 
Effective capacity min 
Effective capacity max 
User defined parameter 1 min 
User defined parameter 1 max 
User defined parameter 2 min 
User defined parameter 2 max 


603.98 gigabits per second 
Q 

255 

0 

255 

C) 

255 


180 

0 

196 

0 

196 

Public switched network 
Maximum security 

0.00 seconds (minimum) 
2013.27 seconds (maximum) 
9.60 kilobits per second 
603.98 gigabits per second 
0 

255 

0 

255 

0 

255 


210 

0 

196 

0 

196 

Public switched network 
Maximum security 

0.00 seconds (minimum) 
2013.27 seconds (maximum) 
4.80 kilobits per second 
603.98 gigabits per second 
0 

255 

0 

255 

0 

255 


240 

0 

255 

0 

Zo 

Public switched network 
Maximum security 

0.00 seconds (minimum) 
2013.27 seconds (maximum) 
0.00 bits per second 
603.98 gigabits per second 
0 

255 

9) 

255 
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User defined parameter 3 min 
User defined parameter 3 max 


Connection Network Information 
BRKEEKRKEKEEKEEKEKEREKEREREREKRERERKRERERERESR 


* Connection Network Information > 
KERKEREKREKRKEREKEKEKEKERKEKERRERERKEKERERKEEE 


Connection network definitions 


1>Connection network name 
Effective capacity 
Cost per connect time 
Cost per byte 
Propagation delay 
User defined parameter 1 
User defined parameter 2 
User defined parameter 3 
Security 
Attached adapters 


1.1>DLC name 
Adapter number 


Directory Information 


REKREKEEKEKEREREREREREREREREKREREREKEERERE 


si Directory Information * 
KKEEKERERRERREERKEEKRERERKEEREREEREREREREKE 


Total directory entries 
Network node entries 


1>Network node CP name 
Number of associated LUs 


1.1>LU name 
Owning CP name 
LU entry type 


1.2>LU name 
Owning CP name 
LU entry type 


1.3>LU name 
Owning CP name 
LU entry type 


1.4>LU name 
Owning CP name 
LU entry type 


1.5>LU name 
Owning CP name 
LU entry type 


Local and adjacent node entries 
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255 


1 


USTBMRA. CONNETW1 


4000000 bits per second 


0 
0 


384.00 microseconds (local area network) 


128 

128 

128 
Nonsecure 
1 


IBMTRNET 
1 


5 
1 


USIBMRA.HENRILU1 
5 


USIBMRA.HENRILUIL 
USTBMRA.HENRILU1 
Home 


USIBMRA. RAK 
USIBMRA. RAK 
Home 


* (wildcard entry) 
USIBMRA. RAK 
Home 


USIBMRA.CLAUDLU1 
USIBMRA.CLAUDLU1 
Register 


USTBMRA. CLAUDLU2 
USIBMRA. CLAUDLU1 
Register 


0 


Intermediate Sessions Information 


KEKEKKEKKEKRKEKEKKREKEREREKEEEKREREERERERKREEE 


* Intermediate Sessions Information * 
KREEKKEKREKKKEKERERKEKEKERERERKRKRKRKRKRRESR 


Number of intermediate sessions 1 

1>Primary side adjacent CP name USIBMRA.CLAUDLU1 
Secondary side adjacent CP name USTIBMRA. RAK 
Primary side link name CLAUDLU1 
Secondary side link name RAKSA20 
Procedure correlator ID (PCID) X'F453930FB4D17E8C' 
PCID generator CP name USIBMRA. CLAUDLU1 


Node Information 


KKEKEKRKEREKEEKREREKRREERKREREREKKKREKERKEKEEEE 


= Node Information ss 
KEEKEKRKEKRKEKKREKERKEEKEREKRREKRERERKEEKREEESE 
Route additional resistance 128 
Maximum directory cache entries 255 
Current directory cache entries 0 
Directory save interval 20 


Topology Information 


KEKEKKKEKKEKEKEKREKKKREKRKEKREREEREKREKEEKEEERE 


* Topology Information > 
KEKKKEKKEKEKKEEKEKEREKEKKEKEREREKEKEKEKKEREKEEKESR 
Number of network nodes 1 
1>Network node CP name USIBMRA.HENRILU1 
Route additional resistance 128 
Congested? No 
Quiescing? No 
ISR depleted? No 
Number of TGs 3 
1.1>TG partner CP name USIBMRA. CONNETW1 
Transmission group number i 
TG partner node type Virtual (connection network) 
Quiescing? No 
Topology Network 
Effective capacity 3.99 megabits per second 
Cost per connect time 0 
Cost per byte 0 
Propagation delay 384.00 microseconds (local area network) 
User defined parameter 1 128 
User defined parameter 2 128 
User defined parameter 3 128 
Security Nonsecure 
1.2>1G partner CP name : USIBMRA.CLAUDLU1 
Transmission group number 21 
TG partner node type Real 
Quiescing? No 
Topology Local 
Effective capacity 3.99 megabits per second 
Cost per connect time 0 
Cost per byte 0 
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Propagation delay 384.00 microseconds (local area network) 


User defined parameter 1 128 
User defined parameter 2 128 
User defined parameter 3 — 128 
Security _ Nonsecure 
1.3>71G partner CP name USIBMRA. RAK 
Transmission group number 0 
TG partner node type | Real 
Quiescing? No 
Topology Local 
Effective capacity 3.99 megabits per second 
Cost per connect time 6) 
Cost per. byte Q 
Propagation delay 384.00 microseconds (local area network) 
User defined parameter 1 128 
User defined parameter 2 128 
User defined parameter 3 128 
Security Nonsecure 
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Appendix C. Traces 


In this appendix there are the following traces: 

e For the end node EN: 
— Summary trace (SENDER.SUM), see Figure 77 on page 261. 

e For the network node NNi: 
— Basic trace (INTER.TRC), see Figure 78 on page 262 
— Detail trace (INTER.DET), see Figure 79 on page 265 
— Summary trace (INTER.SUM), see Figure 80 on page 277. 

e For the network node NN: 
— Summary trace (RECEIVER.SUM), see Figure 81 on page 278. 


We took these traces using the environment shown in the Figure 76. 


@oeoe00eee¢0 000680 @ 


¢ Subarea ° 
« Network ° 


- | SSCP | - 


eoeeoe ee eeoee 


sender receiver 


LU-CP=CLAUDLU1 CP=HENRILUI LU-CP=RALYOS2A 
PLU=RALYOS2A 
Alias of RALYOS2A=KING 


APPCTELL KING This is a message 


Figure 76. Topology of the Network 
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To obtain the same sample traces we did the following: 


¢ Start the trace on EN (sender), NNi (inter) and NN (receiver) by issuing the 
following command from an OS/2 window on each system: 


CMTRACE START /reset /api appc services /data ibmtrnet /event 5 12 /storage 3 
¢ On EN (sender) type APPCTELL KING This is a message 
¢ Stop and format the trace for each network, doing the following: 
— On EN (sender) 
- Select the path that you want to save the files. 
- Type the following command: CMTRACE STOP 
- Type the following command: CMTRACE COPY SENDER. TRC 
- Type the following command: FMTTRACE /D SENDER 
— On NN (receiver) 
- Select the path that you want to save the files. 
- Type the following command: CMTRACE STOP 
- Type the following command: CMTRACE COPY RECEIVER. TRC 
- Type the following command: FMTTRACE /D RECEIVER 
— On NNi (inter) 
- Select the path that you want to save the files. 
- Type the following command: CMTRACE STOP 
- Type the following command: CMTRACE COPY INTER. TRC 
- Type the following command: FMTTRACE /D INTER 


260 = Networking Services/2 


C.1 Summary Trace on an End Node Extremity of Conversation 


FMT TRACE 
(C) Copyright IBM Corporation 1990, 1991 
-Line- --TpId-- -Convid= 2 2 2 ner een enn e eee AP] ------------------- 
-Line- --DLC--- # ------ DA------ LFSID we nee ne nen nene- Flow------------------ 
Ce eee ee eee Convert---------------- > 
6 Kee -------- Convert----------------- 
VO i TPStrted (Df1t,APPCTELL) -------- > 
VO een Convert---------------- > 
22 Kn -------------- Convert----------------- 
26 80bb2T19 Kee Rae See TPStYtedsesesessceeeusese 
BQ ene een Convert---------------- > 
38 <--------------- Convert----------------- 
BO ee nnn Convert---------------- > 
46 <--------------- Convert----------------- 
50 8O0bb2F19 Allocate (KING,#INTER,APPCTELL) ----> 
64 IBMTRNET 00 400032BB119A04 10102 = mm nena FMH5,Locate,Find,CDInit-------- > 
85 IBMTRNET 00 400032BB119A04 10102 Kae ee --- Solicited IPM(1)------------ 
89 IBMTRNET 00 400032BB119A04 00201 Knee - ne FMH5, Locate, Found,CDInit-------- 
106 IBMTRNET 00 400032BB119A04 00201 = —-__ ww nn nnn Solicited IPM(1)----------- > 
110 IBMTRNET 00 400032BB119A04 10202 = wee nen nnn nen- BIND rq---------------- > 
124 IBMTRNET 00 400032BB119A04 00100 Kone nen ---- Solicited IPM(1)------------ 
128 IBMTRNET 00 400032BB119A04 10202 Knee nen - ene --- BIND t+rsp---------------- 
137 80bb2f19 Icce2f19 Keen eee nen Allocate---------------- 
151 8Obb2f19 Icce2f19 ee nee SendData(20,DeaiSync)--------- > 
155 IBMTRNET 00 400032BB119A04 10202 == www nnn nnn ne-- FMH5, FMD--------------- > 
163 IBMTRNET 00 400032BB119A04 10202 <----------- Solicited IPM(7)------------ 
167 IBMTRNET 00 400032BB119A04 10202 Knee eee n nen e ne FMD +rsp---------------- 
170 80bb2f19 1cce2f19 Km en ene nen e----- SendData---------------- 
174 80bb2F19 ene TPEnded (Soft) ------------- > 
178 80bb2f19 <--------------- TPEnded----------------- 


Figure 77. SENDER.SUM File 
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C.2 Basic, Detail and Summary Trace on a Network Node Server 


Basic Trace 


RECV====> 


#:0124 
320502FF 
1OE4E2C9 
F1A37457 
94270024 
QOFAQDS7E 
C1E4C4D3 
F4E4E2C9 
F1143D00 
E4C4D3E4 
4BD9C1D3 
00000008 
15800110 
C5E3E6F1 
00000000 
00808080 
Cl4BC8C5 
04807500 
BO0A2CO2 


320502FF 
1OE4E2C9 
F1A37485 
6F270024 
OFA9DS7E 
C1E4C4D3 
FOE4E2C9 
F1OF3C00 
143D00F3 
D6EZF2C1 
CODSE3C5 
801510E4 
D3E4F 100 
0206/7BC9 


===RFCY====> 


#:000C 
000001 


IBMTRNET #01 400032BB119B04 B4ED/F1C323E6F27 
TH: 2E0001020003 RH:0B9181 


0003D000 
C2D4D9C1 
10714900 
12C 48000 
6010E4E2 
E4F 10043 
C2D4D9C1 
F3E4E2C9 
F1148200 
E8D6E2F2 
7BC9D5E3 
E4E2C9C2 
80098240 
90750000 
17461580 
D5D9C9D3 
00000000 
067BC9D5 


000422F0 
4BC3D3C1 
Q010888CC 
00000018 
C9C2D4D9 
12CA0380 
4BC3D3C1 
C2D4D9C1 
F3E4E2C9 
C1008212 
C5D94040 
D4D9C14B 
0032BB11 
00000000 
1510E4E2 
E4F 10016 
00000001 
E3C5D9 


FOF 30019 
E4C4D3E4 
2F19A481 
60F 45393 
C14BC3D3 
80143C00 
E4C4D3E4 
4BC3D3C1 
C2D4D9C1 
C5000001 
00002046 
C3D6D5D5 
9B041647 
0000014C 
C9C2D4D9 
47000000 
4C008080 


<, USTBMRAKCLAUDLU> 
<1ttW.qI...h./.ua> 
<T'.$.D......-4S1> 
<,ZN=-. USIBMRAKCL> 
<AUDLUIS C..cax's4 See 
<4US IBMRAKCLAUDLU> 
<1.=. 3USIBMRAKCLA> 
<UDLU1.b. 3USIBMRA> 
<KRALYOS2A.b.E...> 
© cu INTER. ex fe 
<,.. USTBMRAKCONN> 
SETWl is Do wee aes G> 
Saka Were aleadew L> 
oa rere F... USIBMR> 
<AKHENRILUI..G...> 
SN keine baste e 
Scie NR > 


IBMTRNET #01 400032BB119B04 B4ED7F1C323E6F27 
TH: 2F0002010000 RH: 830100 


<<... > 


IBMTRNET #01 400032BB119B04 B4ED/F1C323E6F27 
TH: 2C0001020002 RH:0B9181 


0003D000 
C2D4D9C1 
1673D800 
12044000 
6010E4E2 
E4F1003E 
C2D4D9C1 
FAE4E2C9 
E4E2C9C2 
004412C5 
D9404000 
E2C9C2D4 
0A460880 
D5E3C5D9 


000422F0 
4BC8C5D5 
01081A01 
00000018 
C9C2D4D9 
12CB0380 
4BC8C5D5 
C2D4D9C1 
D4D9C14B 
00000100 
00252802 
D9C14BC8 
0003D9C1 


FOF30019 
DOCOD3E4 
97 1C4E3E 
60F45393 
C14BC3D3 
81143C00 
D9COD3E4 
4BD9C1D2 
D9C1D3E8 
90000878 
00174615 
C5D5D9C9 
D2000A2C 


<, USTBMRAKHENRILU> 
=1CTE. SO eeu p.N>> 
<o'.$.D 
<,ZN=-.USIBMRAKCL> 
<AUDLUL FP yiiavdes > 
<6US IBMRAKHENRILU> 
<1.<. 4USTBMRAKRAK> 
<,=, 3USTBMRAKRALY> 
MOSCA ct saaaaus {> 
<INIER:. suttoce lh o> 
<,..USIBMRAKHENRI> 
StU 164 Puce e RAReee? 
<,. {INTER > 


IBMTRNET #01 400032BB119B04 B4ED7F1C323E6F27 
TH: 2D0002010000 RH: 830100 


Figure 78 (Part 1 of 3). INTER.TRC File 
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15:18:29:96 


15:18:29:96 


15:18: 30:00 


15:18:30:00 


31001307 
00000000 
D4D9C14B 
7BC9D5E3 
1104E4E2 
E4F 10010 
D6E2F2C1 
E2C9C2D4 
08020678 
80151054 
D3E4F 100 


31001307 
00000000 
D4D9C14B 
7BC9DSE3 
1104E4E2 
E4F 10010 
D6E2F2C1 
E2C9C2D4 
G8020676 
80151054 
D3E4F 100 


REC V====> 

#:0061 
31001307 
00000000 
7BC9D5E3 
D9C14BD9 
53930FA9 
C3D3C1E4 


31001307 
00000000 
7BCODSE3 
D9C14BD9 
53930FA9 
C3D3C1E4 


Figure 78 (Part 


IBMTRNET #01 400032BB119B04 B4ED/F1C323E6F27 
TH: 2FOQ02020005 RH:6B8100 


BOBO50B7 
00000010 
C3D3C1E4 
C5D90903 
C9C2D4D9 
E4E2C9C2 
6019F 453 
D9C14BC3 
CODSE3C5 
E2C9C2D4 
0A460880 


07808787 
23000010 
C4D3E4F 1 
01815427 
C14BC3D3 
D4D9C14B 
930FA9D5 
D3C1E4C4 
D92B2302 
D9C14BC8 
0003D9C1 


80070602 
E4E2C9C2 
25000702 
A8815427 
C1E4C4D3 
D9C1D3E8 
7E6010E4 
D3E4F12C 
01174615 
C5D5D9C9 
D200 


Stas Piece O0us cee 
ones #,..USIB> 
<MRAKCLAUDLU1%.. .> 
<{INTER...aT'yaT'> 
<,.USIBMRAKCLAUDL> 
<U1..USIBMRAKRALY> 
<QS2A-.4S1.ZN=-.U> 
<STBMRAKCLAUDLU1,> 
<...{INTER+#...F.> 
<,..USIBMRAKHENRI> 
“UT scPsawaRAKe = 


IBMTRNET #01 400032BB119B04 B4ED/7F1C323E6F27 
TH: 2D0000010000 RH:830100 


IBMTRNET #00 40000124000004 AOQE47F1C313E6F27 
TH: 2F0001020005 RH: 6B8000 


BOBOQ50B7 
00000010 
C3D3C1E4 
C5D90903 
C9C2D4D9 
E4E2C9C2 
6019F 453 
D9C14BC3 
CODSE3CS 
E2C9C2D4 
0A460880 


07808787 
23000010 
C4D3E4F 1 
01815427 
C14BC3D3 
D4D9C14B 
930FA9D5 
D3C1E4C4 
D92B2302 
D9C14BC8 
Q0003D9C1 


80070602 
E4E2C9C2 
25000702 
A8815427 
C1E4C4D3 
D9C1D3E8 
7E6010E4 
D3E4F12C 
62174615 
C5D5D9C9 
D200 


= nena er Piesw OO eese > 
Sihiace ly Sage #...USIB> 
<MRAKCLAUDLUI%...> 
<{INTER...aT'yaT'> 
<, US TBMRAKCLAUDL> 
<U1..USIBMRAKRALY> 
<0S2A-.4S1.zN=-.U> 
<SIBMRAKCLAUDLU1,> 
<...{INTER+#...F.> 
<,..USTBMRAKHENRI> 
<LUI..F....RAK. > 


IBMTRNET #00 40000124000004 AOE47F1C313E6F27 
TH: 2F0002010005 RH: EB8000 
BOBQ50B7 00808787 80000602 
00000010 23000000 1E000702 
C5D90203 021105E4 E2c9C2D4 
C1D3E8D6 E2F2C100 006019F4 
D57E6010 E4E2C9C2 D4D9C14B 


C4D3E4F 1 


<{INTER..... USIBM> 
<RAKRALYOS2A. .-.4> 
<$1].ZN=-.USTBMRAK> 
<CLAUDLU1 > 


IBMTRNET #01 400032BB119B04 B4ED/7F1C323E6F27 
TH: 2F0002020005 RH: EB8000 
BOBO5QB7 00808787 80000602 
00000010 23000000 1E000702 


C5D90203 021105E4 E2C9C2D4 
CiD3E8D6 E2F2C100 O06019F 4 


D57E6010 E4E2C9C2 D4D9C14B 


C4D3E4F 1 
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<{INTER.....USIBM> 
<RAKRALYOS2A. .-.4> 
<S].zN=-. USIBMRAK> 
<CLAUDLU1 > 


15:18:30:03 


15:18:30:03 


15:18: 30:03 


15:18:30:71 


15216: 30:71 
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RECV====> IBMTRNET #01 400032BB119B04 B4ED/F1C323E6F27 


=== 15: 
#:0053 TH:2E0002020001 RH: 0BA101 
360502FF 0003D000 4008C1D7 D7C3E3C5 SOiecwed sats ~APPCTE> 
~ 03D30019 10E4E2C9 C2D4D9C1 4BC3D3C1 <LL...USIBMRAKCLA> 
E4C4D3E4 F1A37485 56A4F300 O1081CCE <UDLU1tteVu3..... > 
2F19A281 54270014 54686973 20697320 </.saT'..This is > 
61206065 73736167 6500 <a message. > 
<==SEND===== IBMTRNET #00 40000124000004 AQE47F1C313E6F27 15: 
#:0053 TH:2E90001020001 RH:0BA501 
360502FF 0003D000 4008C1D7 D7C3E3C5 see .APPCTE> 
D3D30019 10E4E2C9 C2D4D9C1 4BC3D3C1 <LL...USIBMRAKCLA> 
E4C4D3E4 F1A37485 56A4F300 01081CCE <UDLUItteVu3..... > 
2F19A281 54270014 54686973 20697320 </.saT'..This is > 
- 61206065 73736167 6500 <a message. > 
<==SEND===== IBMTRNET #01 400032BB119B04 B4ED7F1C323E6F27 ia Fe 
#:000C TH: 2FO0002020000 RH:830100 
000007 Scars > 
=s==RECV====> IBMTRNET #00 40000124000004 AOE47F1C313E6F27 ifor 
#:000C TH:2F0002010000 RH:830100 
000008 <... > 
===RECV====> IBMTRNET #00 40000124000004 AQE47F1C313E6F27 15: 
#:0009 TH:2E0002018000 RH: 83A000 
<==SEND===== IBMTRNET #01 400032BB119B04 B4ED/F1C323E6F2/ 15s 
#:0009 TH:2E0002028000 RH: 83A000 
API REQUEST SERVICES 6107:03A8 155 
1D000000 O0000000 00002020 20202020 Suter bobae ans > 
2O2000FF FFFFFFFF FFFFFFFF FFFFFFFF Sr! panda ume te ta deed > 
FFFFFFFF FFQ00000 GO000000 00000000 Soe Sawaya are aueles > 
000000 < > 
API RETURN SERVICES 0107:03A8 tO: 
1D000000 BO00000N 00802020 20202020 Sig da rigs orate Maes > 
2O2000FA DBEOCOCO COCOEOCO COBOF8CO Me ees candace 8.> 
COCOEOCO CODDNDGON HOHNHOHON HONDHONO ee ere eee: > 
000000 <, > 


18: 


18: 


18: 


18: 


18: 


20: 


20: 


230: 


30: 


30: 


30: 


Si: 


31: 


54; 


54; 


45 


12 


1D 


78 


84 


84 


37 


40 
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FMTTRACE 
(C) Copyright IBM Corporation 1990, 1991 


Line: 2 Recv MU 
Time stamp: 15:18:29:96 
DLC type: IBMTRNET 
Adapter number: 01 
Destination address: 400032BB119B04 
ALS ID: B4ED/7F1C323E6F27 
TH: FID2, OIS, LFSID=0x10201, SNF=0x0003 
RH: RQ, FMD, FI, OIC, RQE1, PI, BB, CEBI 
FMH-5 
Command code = Attach 
User ID already verified = No 
PIP present = No 
Conversation type = Basic 
Synchronization level = None 
Transaction program name = 7003 (APPN Receive network search) 
Logical unit of work identifier: 
LU name = USIBMRA.CLAUDLU1 
Instance number = 0xa3745/71c7149 
Sequence number = 0x0001 
Conversation correlator = 0x88cc2f19a4815427 
Locate 
Chain status = Keep 
Search status = Request 
Fully qualified PCID control vector: 
PCID = 0xf453930fa9d57e60 
Network qualified CP name = USIBMRA.CLAUDLU1 
Find 
Command parameters control] vector: 
Origin information present = Yes 
Associated resource entry control vector: 
Resource type = ENCP 
Resource name = USIBMRA.CLAUDLU1 
Directory entry control vector: 
Resource type = LU 
Resource name = USITBMRA.CLAUDLUI 
Search argument directory entry control vector: 
Resource type = LU 
Resource name = USIBMRA.RALYOS2A 
CDInit 
Format = 0 
Session polarity = OLU is PLU 
Mode name = #INTER 
TG descriptor control vector 
TG identifier control vector 
TG number = 1 
Partner name = USIBMRA.CONNETWI1 
Partner node type = Virtual 
DLC signalling information control vector 
DLC signalling information = 0x400032bb119b04 
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TG Characteristics control vector 
Operational = Yes 
Quiescing = No 
CP-CP sessions supported = No 
Effective capacity = @x/5 
Connect cost = 0x00 
Byte cost = 0x00 
Security = 0x01 
Propagation delay = 0x4c 
Modem class = 0x00 
User defined 1 = 0x80 
User defined 2 = 0x80 
User defined 3 = 0x80 
TG descriptor control vector 
TG identifier control vector 
TG number = 21 
Partner name = USIBMRA.HENRILU1 
Partner node type = Real 
TG Characteristics control vector 
Operational = Yes 
Quiescing = No 
CP-CP sessions supported = Yes 
Effective capacity = @x/5 
Connect cost = 0x00 
Byte cost = 0x00 
Security = 0x01 
Propagation delay = 0x4c 
Modem class = 0x00 
User defined 1 = 0x80 
User defined 2 = 0x80 
User defined 3 = 0x80 
COS/TPF control vector: 
Transmission priority = High 
COS name = #INTER 


Line: 23 Send MU 
Time stamp: 15:18:29:96 
DLC type: IBMTRNET 
Adapter number: Q1 
Destination address: 400032BB119B04 
ALS ID: B4ED7F1C323E6F27 
TH: FID2, Exp, OIS, LFSID=0x10201, SNF=0x0000 
RH: +RSP, FMD, RQN, PI 
Solicited IPM: 
Reset window = No 
Next window size = 1 


Line: 27 Send MU 

Time stamp: 15:18:30:00 

DLC type: IBMTRNET 

Adapter number: 01 

Destination address: 400032BB119B04 

ALS ID: B4ED7F1C323E6F27 

TH: FID2, OIS, LFSID=0x00102, SNF=0x0002 
RH: RQ, FMD, FI, OIC, RQE1, PI, BB, CEBI 
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FMH-5 
Command code = Attach 
User ID already verified = No 
PIP present = No 
Conversation type = Basic 
Synchronization level = None 
Transaction program name = ?003 (APPN Receive network search) 
Logical unit of work identifier: 
LU name = USIBMRA.HENRILU1 
Instance number = 0xa374851673d8 
Sequence number = 0x0001 
Conversation correlator = 0x1a01971c4e3e6f27 
Locate 
Chain status = Discard 
Search status = Complete reply 
Fully qualified PCID control vector: 
PCID = 0xf453930fa9d57e60 
Network qualified CP name = USIBMRA.CLAUDLU1 
Found 
Command parameters control vector: 
Target information present = Yes 
Explicit entry = No 
Associated resource entry control vector: 
Resource type = NNCP 
Resource name = USIBMRA.HENRILU1 
Associated resource entry control vector: 
Resource type = ENCP 
Resource name = USIBMRA.RAK 
Directory entry control vector: 
Resource type = LU 
Resource name = USIBMRA. RALYOS2A 
CDInit 
Format = 0 
Session polarity = OLU is PLU 
Mode name = #INTER 
Route selection control vector: 
Maximum hop count = 2 
Current hop count = 0 
TG descriptor control vector 
TG identifier control vector 
TG number = 21 
Partner name = USIBMRA.HENRILUI 
Partner node type = Real 
TG descriptor control vector 
TG identifier control vector 
TG number = 0 
Partner name = RAK 
Partner node type = Real 
COS/TPF control vector: 
Transmission priority = High 
COS name = #INTER 
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Line: 44 Recv MU 
Time stamp: 15:18:30:00 
DLC type: IBMTRNET 
Adapter number: 01 
Destination address: 400032BB119B04 
ALS ID: B4ED7F1C323E6F27 
TH: FID2, Exp, OIS, LFSID=0x00102, SNF=0x0000 
RH: +RSP, FMD, RQN, PI 
Solicited IPM: 
Reset window = No 
Next window size = 1 


Line: 48 Recv MU 
Time stamp: 15:18:30:03 
DLC type: IBMTRNET 
Adapter number: 01 
Destination address: 400032BB119B04 
ALS ID: B4ED/7F1C323E6F27 
TH: FID2, Exp, OIS, LFSID=0x10202, SNF=0Qx0005 
RH: RQ, SC, FI, OIC, RQD1, Pl 
BIND rq 
Type = Negotiable 
FM profile = 19 
TS profile = 7 
FM usage - primary: 
Chaining use = Multiple-RU chains allowed 
Request control mode = Immediate request mode 
Chain response protocol = Definite or exception response 
Two-phase commit = Not supported 
Compression = Will] not be used 
Send end bracket = Will not send 
FM usage - secondary: 
Chaining use = Multiple-RU chains allowed 
Request control mode = Immediate request mode 
Chain response protocol = Definite or exception response 
Two-phase commit = Not supported 
Compression = Will not be used 
Send end bracket = Will not send 
FM Usage - common: 
Whole BIUS required = No 
FM header usage = Allowed 
Bracket usage and reset state = Brackets are used and reset state is INB 
Alternate code set allowed = No 
BIND queueing allowed = No 
Normal-flow send/receive mode = Half-duplex flip-flop 
Recovery responsibility = Symmetric 
Contention winner = Primary 
Alternate code set = ASCII-8 
Control vectors included = Yes 
Half-duplex flip-flop primary reset state = Send 
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TS usage: 
Secondary to primary pacing stages = One 
Secondary send window size = 7 
Adaptive pacing = Supported 
Secondary receive window size = Q 
Secondary maximum send RU size = 1024 
Primary maximum send RU size = 1024 
Primary to secondary pacing stages = One 
Primary send window size = 0 
Primary receive window size = 7 
PS profile: 
LU type = 6 
LU-6 level = 2 
Conversation-level security = Accepted 
Already-verified indicator = Not accepted 
Synchronization level supported = Confirm 
Session reinitiation responsibility = Operator controlled 
Parallel sessions supported = Yes 
CNOS supported = Yes 
Limited resource = No 
Cryptography options: 
Private cryptography support = No 
Session-level cryptography support = No 
Primary LU name = USIBMRA.CLAUDLU1 
Structured user data: 
Mode name = #INTER 
Session instance identifier = 0x01815427a8815427 
Network-qualified PLU name = USIBMRA.CLAUDLU1 
Secondary LU name = USIBMRA.RALYOS2A 
Fully qualified PCID control vector: 
PCID = 0xf453930fa9d57e60 
Network qualified CP name = USIBMRA.CLAUDLU1 
COS/TPF control vector: 
Transmission priority = High 
COS name = #INTER 
Route selection control vector: 
Maximum hop count = 2 
Current hop count = 1 
TG descriptor control vector 
TG identifier control vector 
TG number = 21 
Partner name = USIBMRA.HENRILU1 
Partner node type = Real 
TG descriptor control vector 
TG identifier control vector 
TG number = 0 
Partner name = RAK 
Partner node type = Real 
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Line: 62 Send MU 
Time stamp: 15:18:30:03 
DLC type: IBMTRNET 
Adapter number: 01 
Destination address: 400032BB119B04 
ALS ID: B4ED7F1C323E6F27 
TH: FID2, Exp, OIS, LFSID=0x00001, SNF=0x0000 
RH: +RSP, FMD, RQN, PI 
Solicited IPM: 
Reset window = No 
Next window size = 1 


Line: 66 Send MU 
Time stamp: 15:18:30:03 
DLC type: IBMTRNET 
Adapter number: 00 
Destination address: 40000124000004 
ALS ID: AQE47F1C313E6F27 
TH: FID2, Exp, OIS, LFSID=0x10102, SNF=0x0005 
RH: RQ, SC, FI, OIC, RQD1 
BIND rq 
Type = Negotiable 
FM profile = 19 
TS profile = 7 
FM usage - primary: 
Chaining use = Multiple-RU chains allowed 
Request control mode = Immediate request mode 
Chain response protocol = Definite or exception response 
Two-phase commit = Not supported 
Compression = Will not be used 
Send end bracket = Will not send 
FM usage - secondary: 
Chaining use = Multiple-RU chains allowed 
Request control mode = Immediate request mode 
Chain response protocol = Definite or exception response 
Two-phase commit = Not supported 
Compression = Will not be used 
Send end bracket = Will not send 
FM Usage - common: 
Whole BIUs required = No 
FM header usage = Allowed 
Bracket usage and reset state = Brackets are used and reset state is INB 
Alternate code set allowed = No 
BIND queueing allowed = No 
Normal-flow send/receive mode = Half-duplex flip-flop 
Recovery responsibility = Symmetric 
Contention winner = Primary 
Alternate code set = ASCII-8 
Control vectors included = Yes 
Half-duplex flip-flop primary reset state = Send 
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TS usage: 
Secondary to primary pacing stages = One 
Secondary send window size = 7 
Adaptive pacing = Supported 
Secondary receive window size = 0 
Secondary maximum send RU size = 1024 
Primary maximum send RU size = 1024 
Primary to secondary pacing stages = One 
Primary send window size = Q 
Primary receive window size = 7 
PS profile: 
LU type = 6 
LU-6 level = 2 
Conversation-level security = Accepted 
Already-verified indicator = Not accepted 
Synchronization level supported = Confirm 
Session reinitiation responsibility = Operator controlled 
Parallel sessions supported = Yes 
CNOS supported = Yes 
Limited resource = No 
Cryptography options: 
Private cryptography support = No 
Session-level cryptography support = No 
Primary LU name = USIBMRA.CLAUDLU1 
Structured user data: 
Mode name = #INTER 
Session instance identifier = 0x01815427a8815427 
Network-qualified PLU name = USIBMRA.CLAUDLU1 
Secondary LU name = USIBMRA.RALYOS2A 
Fully qualified PCID control vector: 
PCID = 0xf453930fa9d5/e60 
Network qualified CP name = USIBMRA.CLAUDLU1 
COS/TPF control vector: 
Transmission priority = High 
COS name = #INTER 
Route selection control vector: 
Maximum hop count = 2 
Current hop count = 2 
TG descriptor control vector 
TG identifier control vector 
TG number = 21 
Partner name = USIBMRA.HENRILUI1 
Partner node type = Real 
TG descriptor control vector 
TG identifier control vector 
TG number = 0 
Partner name = RAK 
Partner node type = Real 
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Line: 80 Recv MU 
Time stamp: 15:18:30:71 
DLC type: IBMTRNET 
Adapter number: 00 
| Destination address: 40000124000004 
ALS ID: AQE47F1C313E6F27 
TH: FID2, Exp, OIS, LFSID=0x10102, SNF=0Qx0005 
RH: +RSP, SC, FI, RQD1 
BIND +rsp 
Type = Negotiable 
FM profile = 19 
TS profile = 7 
FM usage - primary: 
Chaining use = Multiple-RU chains allowed 
Request control mode = Immediate request mode 
Chain response protocol = Definite or exception response 
Two-phase commit = Not supported 
Compression = Will not be used 
Send end bracket = Will not send 
FM usage - secondary: 
Chaining use = Multiple-RU chains allowed 
Request control mode = Immediate request mode 
Chain response protocol = Definite or exception response 
Two-phase commit = Not supported 
Compression = Will not be used 
Send end bracket = Will not send 
FM Usage - common: 
Whole BIUs required = No 
FM header usage = Allowed 
Bracket usage and reset state = Brackets are used and reset state is INB 
Alternate code set allowed = No 
BIND queueing allowed = No 
Normal-flow send/receive mode = Half-duplex flip-flop 
Recovery responsibility = Symmetric 
Contention winner = Primary 
Alternate code set = ASCII-8 
Control vectors included = Yes 
Half-duplex flip-flop primary reset state = Send 
TS usage: 
Secondary to primary pacing stages = One 
Secondary send window size = 0 
Adaptive pacing = Supported 
Secondary receive window size = 0 
Secondary maximum send RU size = 1024 
Primary maximum send RU size = 1024 
Primary to secondary pacing stages = One 
Primary send window size = Q 
Primary receive window size = 0 
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PS profile: 
LU type = 6 
LU-6 level = 2 
Conversation-level security = Accepted 
Already-verified indicator = Not accepted 
Synchronization level supported = Confirm 
Session reinitiation responsibility = Operator controlled 
Parallel sessions supported = Yes 
CNOS supported = Yes 
Limited resource = No 
Cryptography options: 
Private cryptography support = No 
Session-level cryptography support = No 
Primary LU name = 
Structured user data: 
Mode name = #INTER 
Session instance identifier = @x@2 
Network-qualified SLU name = USIBMRA.RALYOS2A 
Fully qualified PCID control vector: 
PCID = 0xf453930fa9d57e60 
Network qualified CP name = USIBMRA.CLAUDLU1 


Line: 89 Send MU 
Time stamp: 15:18:30:71 
DLC type: IBMTRNET 
Adapter number: 01 
Destination address: 400032BB119B04 
ALS ID: B4ED/7F1C323E6F27 
TH: FID2, Exp, OIS, LFSID=0x10202, SNF=0x0005 
RH: +RSP, SC, FI, RQD1 
BIND +rsp 
Type = Negotiable 
FM profile = 19 
TS profile = 7 
FM usage - primary: 
Chaining use = Multiple-RU chains allowed 
Request control] mode = Immediate request mode 
Chain response protocol = Definite or exception response 
Two-phase commit = Not supported 
Compression = Will not be used 
Send end bracket = Will not send 
FM usage - secondary: 
Chaining use = Multiple-RU chains allowed 
Request control mode = Immediate request mode 
Chain response protocol = Definite or exception response 
Two-phase commit = Not supported 
Compression = Will not be used 
Send end bracket = Will not send 
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FM Usage - common: 
Whole BIUs required = No 
FM header usage = Allowed 
Bracket usage and reset state = Brackets are used and reset state is INB 
Alternate code set allowed = No 
BIND queueing allowed = No. 
Normal-flow send/receive mode = Half-duplex flip-flop 
Recovery responsibility = Symmetric 
Contention winner = Primary 
Alternate code set = ASCII-8 
Control vectors included = Yes 
Half-duplex flip-flop primary reset state = Send 
TS usage: 
Secondary to primary pacing stages = One 
Secondary send window size = 0 
Adaptive pacing = Supported 
Secondary receive window size = 0 
Secondary maximum send RU size = 1024 
Primary maximum send RU size = 1024 
Primary to secondary pacing stages = One 
Primary send window size = 0 
Primary receive window size = Q 
PS profile: 
LU type = 6 
LU-6 level = 2 
Conversation-level security = Accepted 
Already-verified indicator = Not accepted 
Synchronization level supported = Confirm 
Session reinitiation responsibility = Operator controlled 
Parallel sessions supported = Yes 
CNOS supported = Yes 
Limited resource = No 
Cryptography options: 
Private cryptography support = No 
Session-level cryptography support = No 
Primary LU name = 
Structured user data: 
Mode name = #INTER 
Session instance identifier = 0x02 
Network-qualified SLU name = USIBMRA.RALYOS2A 
Fully qualified PCID control vector: 
PCID = 0xf453930fa9d57e60 
Network qualified CP name = USIBMRA.CLAUDLU1 


Line: 98 Recv MU 

Time stamp: 15:18:30:75 

DLC type: IBMTRNET 

Adapter number: 01 

Destination address: 400032BB119B04 

ALS ID: B4ED7F1C323E6F27 

TH: FID2, OIS, LFSID=0x10202, SNF=0x0001 
RH: RQ, FMD, FI, OIC, RQD3, PI, CEBI 
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FMH-5 
Command code = Attach 
User ID already verified = No 
PIP present = No 
Conversation type = Basic 
Synchronization level = Confirm 
Transaction program name = APPCTELL 
Logical unit of work identifier: 
LU name = USIBMRA.CLAUDLU1 
Instance number = 0xa3/748556a4f3 
Sequence number = 0x0001 
Conversation correlator = Oxlcce2f19a2815427 
Unrecognized data - remainder of RU follows: 


Hex dump: 
00145468 69732069 73206120 6d657373 <..This is a mess> 
61676500 <age. > 


Line: 106 Send MU 
Time stamp: 15:18:30:75 
DLC type: IBMTRNET 
Adapter number: 00 
Destination address: 40000124000004 
ALS ID: AOQE47F1C313E6F27 
TH: FID2, OIS, LFSID=0x10102, SNF=0x0001 
RH: RQ, FMD, FI, OIC, RQD3, RLWI, PI, CEBI 
FMH-5 
Command code = Attach 
User ID already verified = No 
PIP present = No 
Conversation type = Basic 
Synchronization level = Confirm 
Transaction program name = APPCTELL 
Logical unit of work identifier: 
LU name = USIBMRA.CLAUDLU1 
Instance number = 0xa3/48556a4f3 
Sequence number = Qx0001 
Conversation correlator = O@xlicce2f19a2815427 
Unrecognized data - remainder of RU follows: 


Hex dump: 
00145468 69732069 73206120 6d657373 <,. This iS a mess> 
6167/6500 <age. > 


Line: 114 Send MU 
Time stamp: 15:18:30:75 
DLC type: IBMTRNET 
Adapter number: 01 
Destination address: 400032BB119B04 
ALS ID: B4ED/F1C323E6F27 
TH: FID2, Exp, OIS, LFSID=0x10202, SNF=0x0000 
RH: +RSP, FMD, RQN, PI 
Solicited IPM: 
Reset window = No 
Next window size = 7 


Figure /9 (Part 11 of 12). INTER.DET File 
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Line: 118 Recv MU 
Time stamp: 15:18:30:78 
DLC type: IBMTRNET 
Adapter number: 00 | 
Destination address: 40000124000004 
ALS ID: AQE47F1C313E6F27 
TH: FID2, Exp, OIS, LFSID=0x10102, SNF=0x0000 
| RH: +RSP, FMD, RQN, PI 
Solicited IPM: 
Reset window = No 
Next window size = 8 


Line: 122 Recv MU 

Time stamp: 15:18:31:84 

DLC type: IBMTRNET 

Adapter number: 00 

Destination address: 40000124000004 

ALS ID: AQE47F1C313E6F27 

TH: FID2, OIS, LFSID=0x10102, SNF=0x8000 
RH: +RSP, FMD, RQD3 

FMD +rsp 


Line: 125 Send MU 

Time stamp: 15:18:31:84 

DLC type: IBMTRNET 

Adapter number: 01 

Destination address: 400032BB119B04 

ALS ID: B4ED7F1C323E6F27 

TH: FID2, OIS, LFSID=0x10202, SNF=0x8000 
RH: +RSP, FMD, RQD3 

FMD +rsp 


Line: 128 API request 
Time stamp: 15:20:54:37 


Definelrace 
Hex dump: 
1d000000 DDOG0000 00002020 20202020 S ceateon abies > 
eO2000TT Ffffffttf frffftttf frrfffff <- pee tecune us > 
ffffffff FF9N0000 QNEO0D00 00000000 Si oe ewe oniwees > 
000000 © ics > 


Line: 134 API return 
Time stamp: 15:20:54: 40 
Definelrace 
Primary return code = OK 
Secondary return code = OK 


Hex dump: 
1d000000 O0OH0000N 00002020 20202020 Me ccdetaieis wees > 
202000fa d8eQcOcO cOcHe0cO cO8OF8CO < ..Q{{{{\{{.8{> 
cOcOe0cO c0000000 00000000 99000000 SUN aha tecohies > 
000000 Diets | > 


Figure 79 (Part 12 of 12). INTER.DET File 


276 = Networking Services/2 


Summary Trace 


FMTTRACE 
(C) Copyright IBM Corporation 1990, 1991 


-Line- --TpId-- -ConvIid- 
-Line- --DLC--- 


TBMTRNET 400032BB119B04 FMH5,Locate,Find,CDInit 
IBMTRNET 400032BB119B04 Solicited IPM(1) 
IBMTRNET 400032BB119B04 FMH5,Locate,Found,CDInit 
IBMTRNET 400032BB119B04 Solicited IPM(1) 


IBMTRNET 
IBMTRNET 
IBMTRNET 
IBMTRNET 
TBMTRNET 
TBMTRNET 
IBMTRNET 
IBMTRNET 
TBMTRNET 
IBMTRNET 
TBMTRNET 


400032BB119B04 
400032BB119B04 
40000124000004 
40000124000004 
400032BB119B04 
400032BB119B04 
40000124000004 
400032BB119B04 
40000124000004 
40000124000004 
400032BB119B04 


Figure 80. INTER.SUM File 


FMH5 , FMD 
FMH5 , FMD 


Solicited IPM(7) 
Solicited IPM(8) 


FMD +rsp 
DefTrace 
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C.3 Summary Trace on a Network Node Extremity of Conversation 


FMTTRACE 


(C) Copyright IBM Corporation 1990, 1991 


--TplId-- 
--DLC--- 


‘TBMTRNET 


IBMTRNET 
IBMTRNET 


08009F18 
08009T18 


IBMTRNET 


Q8009T18 
08009T18 
TBMTRNET 
08009f18 
08009T18 
08009F18 


-Convid- 


00 40000124000004 00200 
00 40000124000004 00200 
00 40000124000004 00200 


96fd7f18 
96fd/7f18 
00 40000124000004 00200 
96fd/7F18 
96fd7f18 
00 40000124000004 00200 
96fd7f18 


Figure 87. RECEIVE.SUM File 
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CINIT rq 
Convert- 


wane nena -- RcevAl loc (APPCTELL) ---------- 
<--RcvAl loc (RALYOS2A, CLAUDIO, #INTER) ---- 
wenn nee nn--- RevWait(LL, 1024) ----------- 
wn nn nn nn---- Solicited IPM(7)----------- 
<----RevWait(ConfDeal ,DataCmp] , 20) ------ 


Confirmd 
FMD +rsp 
Confirmd 


wn nennen----- TPEnded (Soft) ------------- 


TPEnded- 


Appendix D. Benchmark Performance Configuration Files 


This appendix is included to provide the configuration files used for the APPC 
performance benchmark TPs. 


By no means should the configuration used for the performance benchmarks be 
construed to be recommended settings for your environment. In addition, no 
claims are made as to the performance gains to be expected by configuring your 
environment to match the benchmark configuration. 


As is often the case, you may need to trade off program size, memory costs, 
usability, and simplicity to gain performance. Consider those aspects when 
making any of the changes suggested here. 


D.1 OS/2 EE 1.2 Communications Manager Configuration (.CFG) 


This section details the specifics of the OS/2 EE 1.2 Communications Manager 
configuration files used in performance benchmark testing. These definitions are 
used by Communications Manager software and token-ring LAN device drivers. 


There are three relevant Communications Manager profiles: 

e JEEE 802.2 token-ring profile 

e IBM token-ring network DLC adapter profile 

¢ Transmission Service Mode Profile. 
These profiles can only be modified through the Advanced Configuration option 
of the Communications Manager. Refer to the OS/2 Extended Edition Version 1.x 


System Administrator's Guide for detailed information about the contents of this 
file. 


IEEE 802.2 Token-Ring Profile 


This profile describes the token-ring interface. This profile was configured on 
each adapter for all testing. 


4Mbps LAN 16Mbps LAN 

Adapter number and version: 0 - 16/4 /A 0 - 16/4 /A 
Load LAN support: Yes Yes 
Use universally administered address: Yes Yes 
Maximum number SAPs: 3 3 
Maximum link stations: 8 8 
Maximum number group SAPs: 0 6) 
Maximum members per group SAPs: 0 0 
Maximum number of users: 3 3 
Transmit buffer size: 2072 4120 
Number of transmit buffers: 2 2 
Receive buffer size: 96 96 
Minimum receive buffers: 49 95 
Adapter "Open" options 

Wrap interface: No No 

Contender: No No 
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Override token release default: 
Group 1 response timer (T1): 
Group 1 acknowledge timer (T2): 
Group 1 inactivity timer (Ti): 
Group 2 response timer (Tl): 
Group 2 acknowledge timer (T2): 
Group 2 inactivity timer (Ti): 
Number of queue elements: 
Number Global Descriptor Table selectors: 


Networking Services/2 


No 


015x40 ms. 
003x40 ms. 
255x400 ms. 
025x40 ms. 
010x40 ms. 
255x40 ms. 


600 
30 


No 
015x40 ms. 
003x40 ms. 
255x40 ms. 
025x40 ms. 
010x40 ms. 
255x40 ms. 
600 
30 


IBM Token-Ring Network DLC Adapter Profile 


This profile describes the token-ring interface. This profile was configured on 


each adapter for all testing. 


Adapter number: 

Load DLC: 

Maximum number of link stations: 
Percent of incoming calls: 
Free unused link: 
Congestion tolerance: 
Maximum RU size: 

Send window count: 

Receive window count: 

C&SM LAN ID: 

Send alert for beaconing: 


Transmission Service Mode Profile 


4Mbps LAN 


RISLAN 
No 


16Mbps LAN 


RISLAN 
No 


This profile describes the mode definitions. These mode definitions are relevant 
for only the base OS/2 EE 1.2 Communications Manager testing. For Networking 


Sservices/2, these mode definitions are implicitly defined. 


This profile was configured on each node for all base OS/2 EE 1.2 Communi- 


cations Manager testing. 


Mode Name 

Minimum RU size 
Maximum RU size 
Receive pacing limit 
Session limit 


Mode Name 

Minimum RU size 
Maximum RU size 
Receive pacing limit 
Session limit 


4Mbps_ LAN 
#BATCH 
2048 

2048 

8 

10 


#INTER 
2048 
2048 

8 

10 


16Mbps LAN 
#BATCH 
4096 

4096 

8 

10 


#INTER 
4096 
4096 

8 

10 
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D.2 Networking Services/2 Configuration (.NDF) 


This section details the configuration files used in Networking Services/2 
benchmark testing. : 


Refer to the /BM SAA Networking Services/2 Installation and Networking Admin- 
istrator Guide and IBM SAA Networking Services/2 System Management Pro- 
gramming Reference for detailed information concerning the contents of these 
files. | 


Server Node 


This Networking Services/2 configuration file was used to define the server node 
for all Networking Services/2 testing. 


DEFINE LOCAL CP fq_cp_name (APPN.NN1) 
node_type(NN) 
cp_alias(NN1) 
nau_address (independent_1u) 
node_id(x'Q0001') 
host_fp support (NO) 


9 


DEFINE DEFAULTS default_mode_name(#BATCH) 
implicit_inbound plu support (yes) 
max_mc_11_send size(32767) 
directory _for_inbound attaches (c:\siddal1\) 
default tp operation(queued operator preloaded) 
default _tp program type (background) 
default _tp conv security rqd(no) 
max_held_alerts(100) 


b 


DEFINE LOGICAL LINK Jink_name(NN2) 
adapter_number (0) 
dic_name(IBMTRNET) 
destination address (x'10005a8a75a5') 
activate _at_startup(no) 
cp_cp_ session support(yes) 
adjacent_node_type(learn) 
limited resource(no) 
link station role(use adapter definition) 


; 


START ATTACH MANAGER; 
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Client Node (2 Node Config) and Intermediate NN (3 Node Config) 
This Networking Services/2 configuration file was used to define the client node 
for the two node Networking Services/2 configuration. This configuration also 
defines the intermediate network node for the three node Networking Services/2 


configuration. 
DEFINE LOCAL CP 


DEFINE DEFAULTS 


DEFINE LOGICAL LINK 


DEFINE LOGICAL LINK 


DEFINE _CPIC SIDE_INFO 


DEFINE CPIC SIDE INFO 


DEFINE _CPIC SIDE_INFO 


fq_cp_name (APPN. NN2) 
node_type(NN) 

cp_alias(NN2) 
nau_address(independent_1u) 
node_id(x'00002') 
host_fp_support (NO) 


3 


default _mode_ name (#BATCH) 

implicit_inbound plu_support (yes) 
max_mc_11_send_size(32767) 

directory for_inbound attaches (c:\siddal1\) 
default _tp operation(queued operator preloaded) 
default_tp program type(background) 
default_tp conv security _rqd(no) 

max_held alerts(100) 


link_name(NN1) 

adapter_number(0) 

dic_name(IBMTRNET) 
destination address (x'10005a884b7b') 
activate at _startup(no) 

cp_cp session support (yes) 

adjacent _node_type(learn) 

limited resource (no) 

link _station_role(use_adapter_definition) 


link_name (NN3) 

adapter_number(1) 

dic_name(IBMTRNET) 
destination address (x'10005a8921ed') 
activate _at_startup(no) 

cp_cp_ session support (yes) 
adjacent_node_type(learn) 

limited resource (no) 

link station role(use adapter definition) 


? 


SYMBOLIC DESTINATION NAME(BCRDTSVC) 
FQ PARTNER LU_NAME(APPN.NN1 ) 
MODE_NAME(#INTER ) 
TP_NAME(BCRDTSVC) ; 


SYMBOLIC DESTINATION NAME (BINQUSVC) 
FQ PARTNER LU_NAME(APPN.NN1 ) 
MODE_NAME(#INTER ) 
TP_NAME(BINQUSVC) ; 


SYMBOLIC DESTINATION NAME (BPIPESVC) 
FQ_PARTNER LU_NAME(APPN.NN1 ) 
MODE_NAME(#BATCH  ) 


Appendix D. Benchmark Performance Configuration Files 


283 


TP_NAME(BPIPESVC) ; 


DEFINE CPIC SIDE INFO SYMBOLIC DESTINATION NAME(BUPDTSVC) 
| FQ_PARTNER LU_NAME(APPN.NN1 ) 
MODE NAME(#INTER ) 
TP_NAME (BUPDTSVC) ; 


DEFINE CPIC SIDE INFO SYMBOLIC DESTINATION NAME(BFILESVC) 
FQ_PARTNER LU_NAME(APPN. NN1 ) 
MODE_NAME(#BATCH  ) 
TP_NAME (BFILESVC) ; 


‘START_ATTACH MANAGER; 
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Client Node (3 Node Configuration) 


This Networking Services/2 configuration file was used to define the client node 
for the three node Networking Services/2 testing. 


DEFINE LOCAL_CP 


DEFINE DEFAULTS 


DEFINE LOGICAL_LINK 


DEFINE CPIC_SIDE_INFO 


DEFINE CPIC SIDE_INFO 


DEFINE CPIC SIDE INFO 


DEFINE CPIC SIDE INFO 


DEFINE CPIC SIDE INFO 


START ATTACH MANAGER; 


fq_cp_name (APPN.NN3) 
node_type(NN) 

cp_alias(NN3) 

nau_address (independent _1lu) 
node_id(x'00003') 

host_fp_ support (NO) 


3 


default_mode_name(#BATCH) 

implicit_inbound plu_support (yes) 
max_mc_11_send_size(32767) 

directory for_inbound attaches (c:\siddal1\) 
default tp operation(queued operator preloaded) 
default tp program type(background) 
default_tp conv security rqd(no) 
max_held_alerts(100) 


3 


link_name (NN2) 

adapter_number (0) 

dic_name(IBMTRNET) 

destination _address(x'10005a88152c') 
activate at _startup(no) 

cp_cp_ session support (yes) 
adjacent node type(learn) 

limited resource (no) 
link_station role(use adapter definition) 


SYMBOLIC DESTINATION NAME(BCRDTSVC) 
FQ PARTNER LU NAME(APPN. NNJ ) 
MODE NAME(#INTER ) 

TP_NAME (BCRDTSVC) ; 


SYMBOLIC DESTINATION NAME(BINQUSVC) 
FQ PARTNER LU_NAME(APPN.NN1 ) 
MODE NAME(#INTER ) 

TP_NAME (BINQUSVC) ; 


SYMBOLIC DESTINATION NAME(BPIPESVC) 
FQ_PARTNER_LU_NAME(APPN. NN1 ) 
MODE_NAME(#BATCH  ) 
TP_NAME(BPIPESVC) ; 


SYMBOLIC DESTINATION NAME(BUPDTSVC) 
FQ PARTNER LU_NAME(APPN.NN1 ) 
MODE_NAME(#INTER  ) 

TP_NAME (BUPDTSVC) ; 


SYMBOLIC DESTINATION NAME(BFILESVC) 
FQ PARTNER LU_NAME(APPN. NN1 ) 
MODE_NAME(#BATCH  ) 
TP_NAME(BFILESVC) ; 
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Index 


A 
ACSAPLDR 27 
ACTIVATE_AT_STARTUP 138 
active configuration 

viewing 42, 49 

viewing remotely 50 
active links 

PMDISPLAY 221 

viewing 51 
adapter 1 

debugging 177 

information includes 51 

PMDISPLAY 219 

viewing active definitions 51 
adapter number 

viewing 51 


adapters 

selecting 72 

two 88 
adaptive pacing 14, 18 
ADDDIRE 144 
address 


debugging 177 
adjacent node CP name 
viewing 51 
adjacent node type 
viewing 51 
ADJACENT _NODE_ TYPE 138 
alert 
NMVT 123 


alert processing with AS/400 154-160 


alerts 154 
AS/400 forwarding 155 
alias 1 
CP 39, 51, 66 
default 69 
definitions 20 
local LUs 52, 64 
partner LUs 52, 65, 113 
5250 emulation 132 
allocation requests 113, 114 
APPC 1 
configuring 23 
enhancements 13-14 
must be installed 19 
viewing active definitions 51 
APPCMGMT 14 
APPCTELL 14, 117 
APPN 1 
enhancements 13-14 
APPN network sample 84 
APPNC 31 
APPNF 14, 187 
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APPNMIG 30, 31, 45, 60 
help 32 
APPNRST 32 
help 32 
APPNT 14, 187 
APPNV 31, 46, 102, 105 
help 32 
APPNV.CTL 30, 191—218 
AS/400 
See a/so AS/400 network node-to-NS/2 end node 
See a/so AS/400 network node-to-NS/2 network 
node 
See a/so AS/400-to-NS/2 via subarea 
See a/so PC support 
See a/so 5250 emulation 
ADDDIRE 144 
CHGCTLAPPC 138 
CHGNETA 155 
configuration 134 
connection network PTF 131 
controller description 141 
cp-to-cp sessions 133 
CRTICFGL 152 
CRTUSRPRF 144 
current status incorrect 158 
directory 134 
directory user 144 
focai point 124, 147, 155 
LIND 141 
management services 134 
migration process 133 
network node server 133 
SOC 155, 158 
VRYCFG 138 
WRKSOC 155 
AS/400 network node-to-NS/2 end node 133-139 
AS/400 changes 138 
communications manager support 134 
editing .NDF file 138 
final configuration 138 
installing Networking Services/2 136 
migrated configuration 136 
verifying the configuration 138 
.NDF file 137 
AS/400 network node-to-NS/2 network node 140-147 
DOS node configuration 145 
links to end nodes 142 
logical link 141 
OS/2 end node configuration 144 
physical connection 141 
5250 emulation 142, 144, 146 
AS/400-to-NS/2 via subarea 147-160 
alert processing 154-160 
AS/400 configuration 152 
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AS/400-to-NS/2 via subarea (continued) 
AS/400 controller description 152 
AS/400 final configuration 153 
device descriptions 153 
NS/2 link to subarea 148 
remote location lists 152 
VTAM configuration 150 

attach manager 
activating at startup 39, 59, 64, 108, 110 
definition 2 
state 52 
TPs started by 113 

ATTRIB 27 

automatic LU lookup 134 

AUTOSTART 181 

autostart trace 48 


background 
starting TPs as 114 
backup server 84-85 
comments 84 
end node definitions 84 
network node definitions 84 
batch 111 
benchmarks 161 
adapter profile 281 
APPC results 164 
conclusions 167 
CPI-C 162 
CPU utilization 168 
credit check 174 
database update 174 
file transfer 176 
high performance file system 173 
inquiry 174 
LAN adapter 171 
limiting component 167 
long 162 
long and CPI-C results 166 
modes 173, 281 
node topology 171 
OS/2 EE 1.2 Communications Manager 172 
OS/2 EE 1.3 173 
performance factors 171 
pipeline transaction 175 
test sequence 173 
token-ring profile 279 
TP parameters 172 
.CFG file 279 
.NDF files 282-285 
Bibliography xxi 
BLDLEVEL 27 


C 


cache LU 53 
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case sensitive 
TP names 114 
CFG file 
See .CFG file 
CF2 file 
See .CF2 file 
change number of sessions 
See CNOS 
CHGCTLAPPC 138 
CHGNETA 155 
choosing network nodes 105 
choosing node types 20 
class of service (COS) 
APPN network 101 
choosing 111 
CPSVCMG) 206, 227, 236 
default 208 
defining a 205 
definition 2 
IBM supplied 111 
information includes 53 
ISTSDCOS 101 
no PM support for defining 55 
PMDISPLAY 232 
SNASVCMG) 206, 227, 239 
subarea 101 
tables 232 
viewing active definitions 53 
#BATCH 111, 226, 249 
H#BATCHSC 111, 226, 252 
#CONNECT 101, 111, 112, 226, 232 
HINTER 111, 227, 242 
#INTERSC 111, 227, 246 
cleaning the node 178 
CMKFMDD 27 
CMKFMSMI 27 
CMTRACE 14, 48 


CNOS 
at startup 115 
implicit 115 


initial session limits 115 
configuration 

AS/400 134 

OS/2 communications manager 134 
configuration file 36 

update 37 
configuration log 38 
configuration log file 

See .LOG file 
configuration management window 35 

configuration file 36 

configure 35 

file 35 

functions 35 
configurations 

See sample configurations 
CONFIG.PCS 145 


CONFIG.SYS 24, 27 
confirmed delivery 174 
connection capability 111 
connection network 87-88, 105, 109, 117-121 

configuring 119 

implicit links 113 

information includes 53 

multiple on same LAN 121 

partitioning 121 

PMDISPLAY 256 

PTF 131 

restricted to ENs and NNs_ 118 

viewing active definitions 53 
connection network name 53, 118 

must be unique 87, 120 
control point 4 

asanLU 4, 111, 117 

AS/400 (157 

configuring 142 

defining in EN 108 

defining in NN 106 

in NAU name space 20 
control point management services units 123 
controller description 141 
conversation 2, 96, 109 
conversation group id 52 
conversation ID 53 

viewing 52 


conversation security 29, 39, 40, 52, 53, 113, 114 


changing 29 
CP alias 
viewing 951 
CP name verification 91 
CP names 
viewing 51 
CP-CP sessions 
after migration 58 
always stay active 70 
AS/400 133 
definition 4 
network node to end node 70 
network node to network node 106 
only one active 70 
CPI communications side information 96 
CPI-C 1, 108, 109 
overhead 168 
performance 161 
CPICFILE 14 
CPICOBOL 14 
CPICREXX 14 
CP_MSUs 
See control point management services units 
CP_NAME 138 
create/quick configure 30, 34, 72-74 
configuration 72 
NDF file 73 
creating .NDF 36 


Credit Check 174 
CRICFGL 152 

CRTUSRPRF 144 
CSMA/CD LAN 88 
C&SM LAN ID 58 


D 
debugging 177-189 
adapter 177 
address 1/7 
check current configuration 178 
error messages 179 
files 177 
state of links 178 
subarea 179 
topology 179 
TP name 177 
tracing 180 
.NDF file 177 
default configuration 24 
default directory 24 
default focal point 125 
default LU) 117 
default mode 112 
default mode name 
viewing 52 
default names 41 
defaults 115 
deinstalling 26 
destination address 
viewing 51 
destination LUs 102 
direct connection 64 
directory 178 
AS/400 134 
distributed search 118 
information includes 53 
PMDISPLAY 256 
transaction programs 113 
viewing active definitions 53 
directory search 70 
directory services 20, 145 
DIRECTORY_FOR_INBOUND_ ATTACHES (*) 
parameter for DEFINE DEFAULTS 113 
disk storage 17 
DISPLAY 14 
display active configuration 42 
display APPC/APPN window 49 
DISPLAY_APPN 14 
distributed search 118 
DLC name 
viewing 51 
DLCs 15 
changing 29 
domain 70 
domain focal point 125 
DOS 141, 145 


Index 
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dump 15 
dynamic updates 178 


end node 
configuring 38, 75, 76 
CP-CP sessions lost 122 
create/quick configure 72—74 
definition 6 
-memory suggestions 18 
not defined to server 121 
end node asa LEN 81-83 
configuring 81 
.NDF file 82 
end node sample 75-76 
configuring 75 
.NDF file 75 
entry point relationship 124 
entry-point 70 
entrywindows 41 
canceling input 41 
optional fields 41 
validating input 41 
EP 
See entry point 
error logs 15 
error messages 179 
ETHERNET 20 
explicit focal point 124 
AS/400 124 
explicit TP definitions 
reasons for 114 


3 


fault tolerance 106 
FILE 14 
FILECFG 14 
filename 
and TP name 114 
files 
debugging 177 
filespecs for TPs 114 
FMTTRACE 14, 47, 49, 182 
FMT.CMD- 187 
focal point 98, 105, 124 
AS/400 124, 147 
default 124 
explicit 124 
NetView 124 
viewing 52 


focal point-end point relationships | 


default 125 
domain 125 
explicit 124 
hierarchy 125 

host 125 

implicit (backup) 125 
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focal point-end point relationships (continued) 


implicit (primary) 124 
format trace window 47 
FP 

See focal point 
FQPCID 54 
frame manager 14 
full-screen 

starting TPs as 114 
fully-qualified LU names 20 


G 


gateway 
PMDISPLAY 230 

global SNA 
information includes 51 
viewing active definitions 51 


H 


hardware requirements 17 
header files 24 
header include files 14 
held alerts 
viewing 52 
help 36 
high performance file system 173 
host connection 96—98 
See a/so primary host connection 
connection sequence 101 
.NDF file 96 
host focal point 125 
HPFS 
See high performance file system 


; 
IBM service 189 
IBMPCNET 20 
IBMTRNET 20 
IDBLK 101 
IDNUM 101 
implicit CNOS 115 
issued any time 115 
implicit links 113 
implicit modes 112 
implicit partner LUs 113 
implicit (backup) focal point 125 
implicit (primary) focal point 124 
inbound allocation requests 114 
independent LUs_ 101 
initial session limits 
and CNOS') 115 
before migration 58 
profile 59 
INSTALL 24 
interactive 111 


intermediate node 89, 118, 140, 145 
performance impact 168 
intermediate routing 118, 140, 150 
intermediate session routing 5, 20, 162 
intermediate sessions 5, 140 
information 257 
information includes 54 
memory requirements 18-19 
PMDISPLAY 257 
viewing active definitions 53 
ISL 
See initial session limit 
ISR 
See intermediate session routing 


L 

LAN 
address 105 
MAC address 118 
must be configured 19 
partitioning 89 

LAN adapter 171 

LAN bridges 140 

LAN DLC 15 

LAN manager 123, 124 

LANDD.SYS 20 

LEN node 58, 70 
configuring 38, 39 
definition 6 

LF70605 
AS/400 PTF 13% 

limited resource definition 
viewing 951 

link definition 
PMDISPLAY 220 

link name 
viewing 51 

link station 2, 51 
number allowed 120 

link station role 51 

links 2 
activating 33, 42 
configuring 38 
creating profile 23 
deactivate hard 42 
deactivate soft 42 
deactivating 14, 33, 42 
debugging 178 
definition 54, 65, 71, 75, 77, 79, 81, 86 
displaying status 42 
dynamically created 118 
implicit 113 
information includes 51 
limited resource 121 
multiple 117 
only defined in EN 121 
SDLC 141, 142 
to network node server 58, 109, 121 


links (continued) 


to primary host 98 
to subarea 91, 93 


viewing active definitions 51 


with CP-CP session 70 


local LU) 15 


configuring 39 


local LU name 


viewing 52 


local node characteristics 


configuring 39 


LOCALDLC 15 
LOG file 


See .LOG file 


logical units 
viewing active definitions 51 
logical units 0 to 3 


LU 


LU 


LU 


LU 


LU 
LU 


LU 


information includes 52 


default 117 


dependent 2, 111, 112, 113, 117 


independent 2, 54, 101 
local 15, 64 

type 0 15, 52 

type 1 15 

type 2. 15, 102, 222 
type 3 15 

type 6.2 xxi, 2, 15, 102 
definition 

PMDISPLAY 226 
names 58, 105 

6.2 

APPN-to-subarea 57, 96 
in primary host 98 
information includes 52 
MODETAB- 103 
performance 13, 14 
usability 15 

viewing information about 
-LU security 39 

-LU session ID 

viewing 52 

-LU sessions state 
viewing 52 


LUA 


LU 


changing 29 

profile 15 

S 

before migration 58 
multiple 117 
PMDISPLAY 222, 223 


M 


MAC address 118 


management services 


found dynamically 118 


52 
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application 123 
AS/400 127, 128, 134 
AS/400-attached end nodes 128 
boundary-attached end nodes 127 
boundary-attached LEN nodes 12/7 
default 128, 129 
domain 128, 129 
domain end nodes 127 
entry point relationship 124 
explicit 128, 129 
focal point 124 
host 127 
information includes 52 
LEN nodes 128 
levels 123 
MS capabilities 124 
NetView 147 
network nodes 128 
PMDISPLAY 226 
sample network 126 
service point relationship 124 
sphere of control 124 
sscp-to-pu session 123 
transforming 123 
viewing active definitions 51 
maximum logical record send size 52 
MC_SEND_CONVERSATION 13 
MDS 
See multiple domain support 
memory suggestions 17 
message logs 15 
MF02095 
AS/400 PTF 131 
migrate configuration 60 
migrate configuration window 45 
migration process 57-64 
AS/400 133 
compatibility 58 
overview 58 
preparation 58 
.CFG definitions 59 
.CFG migration 60 
.NDF contents 61 
migration-level 
MS level 123 
minimum configuration requirements 
mode definition 
PMDISPLAY 226 
mode name 
default 209 
viewing 52 
mode table 
subarea 102 
modes 
before migration 58 
BLANK 55, 100, 112, 226 
changing parameters 29 
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modes (continued) 
choosing 112 
configuring 39, 65, 72, 112 


CPSVCMG 100, 209, 212, 214, 224, 227 


default 55, 101, 112 


definition 3 
IBM-supplied 100, 112 
implicit 112 
information includes 52 
profile 23 


QPCSUPP 137 


SNASVCMG 100, 123, 213, 224, 225, 227 


subarea 100 
viewing active definitions 51 
#BATCH 100, 112, 226 
#BATCHSC 100, 112, 226 
#INTER 100, 112, 227 
#INTERSC 100, 112, 227 
MS capabilities 124, 128, 155 
multiple domain support 
MS level 123 
multiple links 117 
multiple LUs 111, 117 


naming convention 92, 105 
NAU address 111 
NAU names) 20 
NCP levels 100 
NCP major node 101 
NDF file 
See .NDF file 
NETID 20, 58, 96 
configuring 39 
NetView 98, 147, 154 
NetView/PC 124 
network definition file 
See .NDF 
network ID 58, 105 
network management vector transport 
MS level 123 
network name 
configuring 39 
viewing 51 
network node 
served end nodes not defined 121 
network node server 71-72 
AS/400 133 
configuration 71 
definition 5 
memory suggestions 18 
multiple on LAN 120 
processor recommendations 19 
.NDF file 71 
network node serving LEN 78-81 
configuring 78 
.NDF file 79 


network node to network node 86—87 
configuration 86 
.NDF file 86 
network node to non-domain end node 76-78 
configuring 76 
.NDF file 77 
network nodes 
choosing 20 
configuration overview 70 
configuring 38 
definition 5 
memory suggestions 18 
performance 162 
NMVT 
See network management vector transport 
NMVT alerts 
viewing 52 
node 
information includes 54 
viewing active definitions 53 
node ID 
configuring 39 
viewing 51 
node information 
PMDISPLAY 257 
node name 
configuring 39, 111 
minimum configuration requirements 111 
node type 
configuring 39 
viewing 51 
non-queued TPs 114 
NS/2 group 
configuration management 34 
create/quick 34 
functions 33 
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optimum route 112 

optional fields 41 

options 36 

OS/2 communications manager 
configuration 134 

owning CP name 53 
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pacing type 
viewing 952 

pacing window 112 

parallel links 6 

parameter mapping 
AS/400-to-communications manager 135 
NS/2-to-AS/400 143 

partner location 20 
dynamically learned 20 

partner LU name 
fully-qualified 113 


partner LUs 
aliases 52, 113 
and subarea transport 92 
before migration 58 
changing parameters 29 
configuring 20, 39, 41, 65, 79, 93 
definition 3 
definitions 113 
dynamically found 117 
implicit 52, 113 
information includes 52 
location defined 64 
PMDISPLAY 227 
reasons to define 113 
viewing 52 
viewing active definitions 51 
viewing modes 52 
“dummy” alias 132 
PC support 131, 140 
CONFIG.PCS 145 
DOS 145 
DOS version 141 
INSTALL.EXE 131 
PTF level 131 
STARTPCS.BAT 146 
trap ‘O00D’x 131 
peer connection 64—69 
configuring 64 
overview 64 
.NDF file 66 
peer node 
configuring 39 
performance 14 
changes to .CFG file 169 
changes to .NDF file 169 
network node 162 
TP data buffer sizes 170 
performance benchmarks 
See benchmarks 
performance improvement 167 
planning considerations 
definition considerations 20 
network names 20 
node types 20 
PMDISPLAY 
active links 221 
active transaction programs 231 
adapter information 219 
class of service 232 
connection networks 256 
directory 256 
gateway information 230 
intermediate sessions 257 
link definition 220 
logical unit 223 
logical units 222 
LU definition 226 
management services 226 
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PMDISPLAY (continued) 
mode definition 226 
node 25/7 
partner LU definitions 227 
sessions 228 
SNA global information 220 
system defaults 231 | 
topology 257 
transaction programs 231 
X.25 link 232 
PMDSPLAY 50 
portability 117 
preferred NN server 70 
two causes error 73 
viewing 51 
Presentation Manager windows 
- (collapse) 40 
change sub-item 40 
create sub-time 40 
delete sub-item 41 
entrywindow 41 
help 36, 41 
optional fields 41 
options 36 
refresh 42 
starting TPsin 114 
view 36 
. (no sub-items) 40 
+ (expand) 40 
primary host 98 
configuring 38 
connection sequence 101 
definition 7 
only one 39 
.NDF file 98 
primary host connection 98—99 
processor recommendations 19 
PU macro 101 
CPNAME 101 
XID 101 
PU name 58 
publications xxi 
AS/400 xxii 
ITSC xxii 
Networking Services/2 xxi 
Operating System/2 xxi 
prerequisite xxi 
SNA xxi 
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registration 134 
remote workstation 


viewing active configuration 50 


removing NS/2 26 
report a problem 189 
RESOURCE ID 127, 128 
route 118 


choosing 112 


route additional resistance 54 
router 88—91 


configuration 88 
.NDF file 89 


routing between LANs) 122 
RU size 18, 112 
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sample APPN network 105-110 
sample configurations 57 


See a/so AS/400 network node-to-NS/2 end node 

See a/so AS/400 network node-to-NS/2 network 
node 

See a/so AS/400-to-NS/2 via subarea 

See a/so backup server 
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See a/so end node as a LEN 

See a/so end node sample 

See a/so host connection 
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See a/so network node server 

See a/so network node to network node 

See a/so network node to non-domain end node 

See a/so network node to served LEN 

See a/so peer connection 
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See a/so router 

See a/so subarea definitions 

See a/so subarea transport 
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directories 26 
storage 17 


saving .NDF 37 
SDLC 15, 88, 140, 141 
SEC file 


See .SEC file 


secure logical links 111 
security configuration 29 
segmenting 14 
SEND_CONVERSATION 13 
service point 124 
session ids 


viewing 52 
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changing 29 

initial 13, 29, 58, 59 
LU 59 

mode 65 

PLU 59 


session limits (continued) 
profile 23, 59 
session security 59, 111 
sessions 
See a/so CP-CP sessions 
See a/so intermediate sessions 
deactivating 14 
definition 3 
information includes 52 
memory requirements 17—19 
parallel 2, 3, 4, 52, 55, 117 
PMDISPLAY 228 
preactivated 108, 109 
single 112, 113 
SSCP-to-PU 123, 125-129 
viewing active definitions 51 
SNA base 
changing 29 
SNA feature profile 29 
SNA gateway 15 
information includes 52 
viewing active definitions 51 
SNA global information 
PMDISPLAY 220 
SNI gateway 20 
SOC 
See sphere of control 
SOC node 124 
software requirements 19 
softwares versions 51 
SP 
- See service point 
sphere of control 124, 155 
deleting entry 158 
sscp-to-pu session 123 
start trace 49 
starting NS/2 27 
starting TPs 113 
STARTPCS.BAT 146 
start/stop trace 48 
stop trace 49 
STOPFM 26 
stopping NS/2 27 
storage 17 
subarea 179 
debugging 179 
subarea information 99-104 
class of service (COS) 101 
ISTSDCOS 101 
logon mode table 102 
LU6.2 101 
modes 100 
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other LUs 102 
PUs 101 
VTAM levels 100 
VTAM list 103 
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subarea transport 92—96 
configuration 92 
connection sequence 101 
NDF file 94 
subsystem management 15 
switched major node _ 101 
system defaults 
information includes 52 
PMDISPLAY 231 
viewing active definitions 51 
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TOKEN-RING 88 
tools 14 
topology 106, 179 
information includes 54 
PMDISPLAY 257 
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trace 15, 180—189 
APPNF.CMD- 187 
APPNT.CMD 187 
autostart 48, 181 
batch files 186 
CM trace 180 
copy 49 
events 180 
examples 180, 261—278 
flags 182 
FMT.CMD 187 
format 47 
formatting 182, 184 
input for formatting 183, 185 
output from formatting 185 
sequence 188 
start 49 
start/stop 48 
stop 49 
TRC.CMD 187 
.DET 183 
SUM 183 
TRC file 47 
transaction program defaults 
configuring 39 
transaction program name 
debugging 177 
transaction program security 
configuring 39 
transaction programs 
batch send 176 
before migration 58 
benchmark 161 
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transaction programs (continued) verbs (continued) 


configuring 39, 65 DEFINE TP 55, 108, 109, 210 
confirmed delivery 174 IMPLICIT_INBOUND PLU_SUPPORT 64 
conversational reply 174 parameters 215-217 

credit check 174 START_ATTACH_MANAGER 212 
database update 174 START_ATTACH_MANAGER _ 108, 110 
defaults 115, 177 verification program 15, 49 
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directory 113 verify configuration window 46 

explicit definitions 114 view 36 

file transfer 176 vio-windowable 

filespecs 114 starting TPs as 114 

information includes 52 VRYCFG 138 

inquiry 174 VTAM~ 150 

names 113, 114 PU macro 101 

one way bracket 175 switched major nodes 150 
parameters for benchmarks 172 VTAM levels 100 


pipeline transaction 175 
PMDISPLAY 231 


portability 117 W 
program type 114 WAN 140 
queued 113 wide area network 140 
request and reply 174 WILDCARD 20, 82, 92 
sample definitions 231 full 92 
starting 113 partial 92 
viewing active definitions 51 WRKSOC 155 
transmission group number 
viewing 51 x 
TRC.CMD 187 
twinaxial 15 XID exchange 101 
T2.1 node 4 X25 15, 88 
X.29 link 
PMDISPLAY 232 
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undefined adjacent node 113 | information includes 53 
uninterpreted name 52 secure 111 
unsolicited data 124 viewing active definitions 51 
update 37 
usability 15 Numerics 
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V 5250 emulation 132 
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ACTIVATE_AT_STARTUP 82 and DOS 146 
ACTIVATE_DLC 55 changing 29 
ACTIVATE_LOGICAL_LINKS 213 partner LU alias 132 
CNOS _ 55, 63, 108, 213 80386 processor 19 
DEFINE CONNECTION _NETWORK 54, 88, 199 80486 processor 19, 173 
DEFINE COS 55, 205 
DEFINE CPIC_SIDE_INFO 98, 108, 109, 211 . 
DEFINE DEFAULTS 55, 108, 109, 113, 115, 209 Special Characters 
DEFINE LOCAL_CP 54, 106, 111, 136, 199 CFG file 24, 29 
DEFINE _LOCAL_LU 133, 203 copying 3/7 
DEFINE LOGICAL_LINK 54, 141, 148, 200 migrating 31 
DEFINE MODE 133, 208 CF2 file 15, 29 
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.DET file 47 
.LOG file 37, 38 
created by APPNMIG 60 
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.NDF file 15, 29 
building 30, 31, 36 
changes for AS/400 138 
configuring 38 
copying 37 
created by APPNMIG 60, 61 
debugging 177 
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saving 37 
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